Summary
Connects Claude to the Terranode Geospatial API for spatial queries against US datasets. You get five tools: point-in-polygon lookups to find which feature contains a coordinate, nearest feature search with distances, geodesic distance calculations between two points, spatial joins to enrich multiple coordinates at once, and dataset listing. Requires a Terranode API key from app.terranode.co. Works through stdio transport via npx. Useful when you need to resolve coordinates to administrative boundaries like counties or ZIP codes, find proximity to features, or batch-process location data without writing geospatial query code yourself.
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →
@terranode-co/mcp-server
MCP server for spatial queries via the Terranode Geospatial API. Gives AI agents (Claude Desktop, Cursor, etc.) tools to query geospatial datasets — point-in-polygon lookups, nearest feature search, distance calculations, and spatial joins.
Prerequisites
- Node.js 18+
- A Terranode API key — sign up at app.terranode.co
Setup
Claude Desktop
Add to your claude_desktop_config.json:
{
"mcpServers": {
"terranode": {
"command": "npx",
"args": ["@terranode-co/mcp-server"],
"env": {
"TERRANODE_API_KEY": "your-api-key-here"
}
}
}
}
Cursor
Add to your Cursor MCP settings (.cursor/mcp.json):
{
"mcpServers": {
"terranode": {
"command": "npx",
"args": ["@terranode-co/mcp-server"],
"env": {
"TERRANODE_API_KEY": "your-api-key-here"
}
}
}
}
Claude Code
Add to your Claude Code MCP settings:
{
"mcpServers": {
"terranode": {
"command": "npx",
"args": ["@terranode-co/mcp-server"],
"env": {
"TERRANODE_API_KEY": "your-api-key-here"
}
}
}
}
Available tools
| Tool | Description |
|---|---|
list_datasets | List all available geospatial datasets (system + custom) |
check_location | Point-in-polygon: which feature contains a coordinate? |
find_nearest | Find the N nearest features to a coordinate, with distances |
calculate_distance | Geodesic distance between two points (meters + miles) |
spatial_join | Enrich multiple coordinates with polygon attributes at once |
Example prompts
Try these in Claude Desktop or Cursor:
- "What county is latitude 40.71, longitude -74.00 in?"
- "What datasets are available?"
- "Find the 3 nearest counties to Central Park"
- "How close is my proposed site (40.7128, -74.006) to the nearest school (34.0522, -118.2437)?"
- "Which states do these 5 warehouse locations fall in?" (paste coordinates)
- "What ZIP code is 37.7749, -122.4194 in?"
API Reference
The full API spec is available at docs.terranode.co/openapi.yaml (OpenAPI 3.1).
Feedback
Report issues or feature requests: feedback@terranode.co
Featured
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →Configuration
TERRANODE_API_KEY*secretAPI key from app.terranode.co
TERRANODE_API_URLdefault: https://api.terranode.coAPI base URL (defaults to https://api.terranode.co)
Registryactive
Package@terranode-co/mcp-server
TransportSTDIO
AuthRequired
UpdatedApr 13, 2026