# datosmcp

> Agent-first public data for Central America (Guatemala, El Salvador, Honduras, Nicaragua, Costa Rica, Panama, Belize, Dominican Republic): banking, poverty, consumer spending, prices, trade, investment, labour, crime, education, health, population, energy, climate and procurement — by country, department and municipality. Answers are JSON with sources, gaps and honest regional rollups. Spanish or English.

MCP server (streamable HTTP; a free account is required — Claude and other MCP clients sign in with OAuth automatically, or send an API key): https://mcp.datosmcp.com/mcp
Claude Code: `claude mcp add --transport http datosmcp https://mcp.datosmcp.com/mcp`

## Try it with no account
```
curl -s "https://api.datosmcp.com/api/v1/try?q=pobreza+Guatemala"
```
10 calls an hour, 30 a day per address; up to 25 rows from the latest 3 periods. Everything else needs a free account (below).

## Get an API key from a terminal (no browser)
```
curl -s https://api.datosmcp.com/api/v1/agent/signup -H 'content-type: application/json' -d '{"email":"human@example.com","name":"my-agent"}'
```
Returns `api_key` immediately with limits of 20 calls/min and 200/day. A 6-digit code is emailed; once a human passes it on, confirm it to lift the limits to the free plan:
```
curl -s https://api.datosmcp.com/api/v1/agent/confirm -H 'content-type: application/json' -H 'x-api-key: dmk_…' -d '{"email":"human@example.com","code":"123456"}'
```
Send your key with the confirmation: it keeps working at full free limits, and any other key or session made before confirmation is revoked. Until the email is confirmed, the key cannot publish, subscribe or pay. Send the key as `x-api-key: dmk_…` or `Authorization: Bearer dmk_…`.

## Referral program (for agent and app builders)
Add "ref": "YOURCODE" to /api/v1/agent/signup, or link people to https://datosmcp.com/?ref=YOURCODE. You earn 20% of each referred account's payments for 12 months. Get your code at https://datosmcp.com/account.

## Disclaimer
Data is only as reliable as its sources: it can contain errors, revisions and gaps. AI-generated answers, summaries and place or indicator matches can be wrong. Verify anything important against the cited source. Provided as-is without warranty; see https://datosmcp.com/terms.

## ChatGPT and the OpenAI API
- ChatGPT: Settings → Apps & Connectors → Advanced → Developer mode → Create → https://mcp.datosmcp.com/mcp (OAuth). Charts and maps render in the chat (MCP Apps widget).
- Deep research / company knowledge: use the `search` and `fetch` tools (results carry citable URLs).
- Responses API: `tools: [{"type": "mcp", "server_label": "datosmcp", "server_url": "https://mcp.datosmcp.com/mcp", "headers": {"x-api-key": "dmk_…"}, "require_approval": "never"}]`

## Tools
- search_data: plain-language question → data (rows, matrix, gaps, sources, alternatives)
- query_data: structured query over indicators × places × periods; rollups (CA7, SICA8, NTCA), drill-down to department/municipality, GeoJSON output
- resolve_place: "Xela", "zona 10", "San Pedro, San Marcos", or lat/lon → official code + hierarchy
- enrich_place: everything known about one place, most local value first
- find_indicators, describe_indicator, list_places

## Docs
- [Query format](https://datosmcp.com/docs/query)
- [Query JSON Schema](https://datosmcp.com/schema/query.json)
- [Data freshness](https://datosmcp.com/api/v1/freshness)
- [Privacy](https://datosmcp.com/privacy) · [Terms](https://datosmcp.com/terms)

## REST (send x-api-key: dmk_… or Authorization: Bearer …)
- GET https://api.datosmcp.com/api/v1/search?q=remesas+Honduras+desde+2015
- POST https://api.datosmcp.com/api/v1/query
- GET https://api.datosmcp.com/api/v1/places/resolve?q=Xela
- GET https://api.datosmcp.com/api/v1/places/GT0901/profile