Complete reference for all available MCP tools.
Find available locations for mapping.
GET /api/mcp/tools/list-locations
Parameters:
| Param | Type | Description |
|---|---|---|
type | string | country, subdivision, or city |
q | string | Search query |
parent | string | Parent location code (e.g., us) |
limit | number | Max results (default: 50) |
Example:
curl 'https://api.smavatar.com/api/mcp/tools/list-locations?type=subdivision&q=california'
Get detailed information about a location.
GET /api/mcp/tools/get-location-details
Parameters:
| Param | Type | Description |
|---|---|---|
id | string | Location UUID |
Example:
curl 'https://api.smavatar.com/api/mcp/tools/get-location-details?id=bdd56f14-e776-418a-ab18-89c8138df978'
Find rivers and lakes for a location. Requires API key.
GET /api/mcp/tools/list-features
Parameters:
| Param | Type | Description |
|---|---|---|
location_id | string | Location UUID |
type | string | river or lake |
max_importance | number | Filter by importance (1-5) |
limit | number | Max results (default: 50) |
Example:
curl 'https://api.smavatar.com/api/mcp/tools/list-features?location_id=...' \
-H 'Authorization: Bearer sma_your_key'
List available map themes.
GET /api/mcp/tools/list-themes
Example:
curl 'https://api.smavatar.com/api/mcp/tools/list-themes'
Get detailed theme styling information.
GET /api/mcp/tools/get-theme-details
Parameters:
| Param | Type | Description |
|---|---|---|
name | string | Theme name (e.g., modern) |
Get explicit list of what SMAvatar can and cannot do. Use this to prevent hallucination.
GET /api/mcp/tools/get-capabilities
Response:
{
"supported": [
"country_maps",
"state_maps",
"subdivision_highlighting",
"rivers_and_lakes",
"multiple_themes"
],
"not_supported": [
"3d_maps",
"real_time_data",
"street_level_maps",
"custom_geodata_upload"
]
}
Search SMAvatar documentation.
GET /api/mcp/tools/search-documentation
Parameters:
| Param | Type | Description |
|---|---|---|
query | string | Search query (min 2 chars) |
section | string | Filter by section |
Example:
curl 'https://api.smavatar.com/api/mcp/tools/search-documentation?query=highlighting'
Get ready-to-use API examples.
GET /api/mcp/tools/get-api-example
Parameters:
| Param | Type | Description |
|---|---|---|
scenario | string | Example scenario |
Scenarios:
country-map - Simple country mapstate-with-rivers - State with water featuresstate-with-cities - State with city labelshighlighted-region - Quiz-style highlighted mapExample:
curl 'https://api.smavatar.com/api/mcp/tools/get-api-example?scenario=country-map'
Get educational use case examples.
GET /api/mcp/tools/get-use-case-examples
Example:
curl 'https://api.smavatar.com/api/mcp/tools/get-use-case-examples'
{
"statusCode": 429,
"message": "Anonymous rate limit. Use API key for 10x higher limits."
}
{
"statusCode": 401,
"message": "API key required for list-features. Sign up at smavatar.com"
}
{
"statusCode": 400,
"message": "Query must be at least 2 characters"
}