Reference
Data source: Embedded (ISO 3166)
MCP Protocol
Endpoint
https://context.gnist.ai/mcp/country-info/
claude_desktop_config.json
{
"mcpServers": {
"gnist-country-info": {
"url": "https://context.gnist.ai/mcp/country-info/",
"headers": {
"Gnist-API-Key": "YOUR_API_KEY"
}
}
}
}
Shell
curl -X POST "https://context.gnist.ai/mcp/country-info/" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-H "Gnist-API-Key: YOUR_API_KEY" \
-d '{"jsonrpc": "2.0", "method": "tools/call", "id": 1, "params": {"name": "get_country", "arguments": {"code": "example"}}}'
REST API
API Root
https://context.gnist.ai/rest/country-info/
5 endpoints available:
GET /rest/country-info/get_countryGET /rest/country-info/search_countriesGET /rest/country-info/list_countries_by_regionGET /rest/country-info/get_country_statsGET /rest/country-info/report_feedback
Shell
curl "https://context.gnist.ai/rest/country-info/get_country?code=example" \ -H "Gnist-API-Key: YOUR_API_KEY"
Python
import httpx
resp = httpx.get(
"https://context.gnist.ai/rest/country-info/get_country",
headers={"Gnist-API-Key": "YOUR_API_KEY"},
params={
"code": "example"
},
)
print(resp.json())
Command Line
Command
gc country-info
CLI documentation will be available when the GnistAI SDK is published.
Install
pip install gnistai
Available Tools (5)
get_countryGet detailed information about a country by ISO code (alpha-2 or alpha-3).
| Parameter | Type | Required | Description |
|---|---|---|---|
code | string | required |
search_countriesSearch countries by name (case-insensitive partial match).
| Parameter | Type | Required | Description |
|---|---|---|---|
query | string | required | |
limit | integer | optional | (default: 10) |
list_countries_by_regionList all countries in a given region.
| Parameter | Type | Required | Description |
|---|---|---|---|
region | string | required |
get_country_statsGet summary statistics about countries in the database.
report_feedbackReport a bug, feature request, or general feedback for this data source.
| Parameter | Type | Required | Description |
|---|---|---|---|
feedback | string | required | |
feedback_type | string | optional | (default: "general") |