Overview
MCP server for LLM integration.
MCP Server
SMAvatar includes a Model Context Protocol (MCP) server that enables LLMs to discover locations, themes, and generate API requests through conversation.
What is MCP?
MCP is a standard for LLM tool integration. AI assistants can:
- Discover available locations, themes, and styles
- Query features and capabilities
- Generate valid API requests
Use Cases
Conversational Map Creation
"Create a map of the US with Idaho highlighted in blue"
Educational Assistants
Build AI tutors that generate geography materials on demand.
Developer Tools
Let AI assistants help integrate SMAvatar APIs.
Base URL
https://api.smavatar.com/api/mcp
Available Tools
Discovery (No Auth Required)
| Tool | Description |
|---|---|
list-locations | Find countries, states, cities |
get-location-details | Get location bounds and info |
list-themes | List map themes |
get-theme-details | Get theme styling info |
get-capabilities | What SMAvatar can/can't do |
Discovery (API Key Required)
| Tool | Description |
|---|---|
list-features | Find rivers and lakes |
get-feature-details | Get feature geometry |
Learning
| Tool | Description |
|---|---|
search-documentation | Search docs |
get-api-example | Get ready-to-use examples |
get-use-case-examples | Educational examples |
Rate Limits
| Tier | Limit |
|---|---|
| Anonymous | 600 requests/hour |
| API Key | 600 requests/hour |
| Admin | Unlimited |
Some tools cost more against your quota:
| Tool | Cost |
|---|---|
list-locations | 1 |
list-features | 5 |
search-documentation | 3 |
Quick Example
An LLM might process "Create a US map with California highlighted":
list-locations?type=country&q=united states→ Get US IDlist-locations?type=subdivision&q=california→ Get CA codeget-api-example?scenario=country-map→ Get template- Return complete API request to user