Developers
API & MCP
Pull every table behind this dashboard as JSON or CSV, or connect an AI agent to the dataset through the Model Context Protocol. Data runs from 2013-Q1 to 2026-Q2, in USD, with no key required.
Try a request
Endpoints
/api/v1/metaCoverage, sources, citation and the endpoint list. Start here to see which periods exist.
- format
- json (default) or csv
/api/v1/nationalTotal remittances received by Mexico, all periods.
- freq
- yearly (default) or quarterly
- format
- json or csv
/api/v1/mexico/statesOne period, all 32 states, ranked by amount received.
- year
- required, e.g. 2025
- quarter
- Q1 to Q4; omit for the annual total
- format
- json or csv
/api/v1/mexico/states/timeseriesFull series for one state, or for every state at once.
- state
- exact name, e.g. Michoacán de Ocampo; omit for all
- freq
- quarterly (default) or yearly
- format
- json or csv
/api/v1/mexico/municipalitiesOne year, ranked municipalities. Municipal figures are published annually only.
- year
- required, e.g. 2025
- state
- restrict to one state
- limit
- default 100, max 2500
- offset
- for paging
- format
- json or csv
/api/v1/us/statesRemittances sent by US state, with the Mexican-born population of that state.
- year
- required, e.g. 2024
- quarter
- Q1 to Q4; omit for the annual total
- format
- json or csv
Pull the data
curl "https://remittances.mx/api/v1/mexico/states?year=2025"import pandas as pd
df = pd.read_csv("https://remittances.mx/api/v1/mexico/states?year=2025&format=csv")
df.head()Every endpoint accepts format=csv, sends permissive CORS headers, and needs no authentication. Responses are cached for an hour at the edge.
MCP server
The repository ships an MCP server that exposes these endpoints as tools, so Claude Code, Claude Desktop or any MCP client can query the dataset directly. It is a single dependency-free Node script at mcp/remittances-mcp.mjs.
claude mcp add remittances -- node /path/to/remittances/mcp/remittances-mcp.mjs{
"mcpServers": {
"remittances": {
"command": "node",
"args": ["/path/to/remittances/mcp/remittances-mcp.mjs"],
"env": { "REMITTANCES_API_BASE": "https://remittances.mx" }
}
}
}| Tool | Returns |
|---|---|
| get_coverage | Periods available, counts, sources |
| get_national_totals | National series, yearly or quarterly |
| get_mexico_states | State ranking for one period |
| get_mexico_state_timeseries | One state over time |
| get_mexico_municipalities | Municipal ranking for one year |
| get_us_states | US sending states for one period |
Frequently asked questions
Do I need an API key to use the remittances API?
No. Every endpoint under /api/v1 is open, needs no key or registration, and sends permissive CORS headers so browsers and notebooks can call it directly.
What units and currency does the data use?
All amounts are current US dollars, unrounded, in the amount_usd field. Values are not adjusted for inflation or converted to pesos.
How often is the remittance data updated?
Banco de Mexico publishes remittances quarterly, roughly six weeks after each quarter closes. Mexican state and municipal figures currently run through 2026-Q2; US state-of-origin figures come from a separate Banco de Mexico product and lag by a quarter or two. Call /api/v1/meta for exact coverage.
How much did Mexico receive in remittances in 2025?
Mexico received about $62.5 billion USD in 2025 across all 32 states, down roughly 4 percent from about $65.0 billion in 2024, the first annual decline in the series that starts in 2013.
Which Mexican states receive the most remittances?
Guanajuato, Michoacan de Ocampo and Jalisco lead in total volume, followed by Chiapas, Estado de Mexico and Ciudad de Mexico. Call /api/v1/mexico/states?year=2025 for the full ranking.
Is municipal remittance data available quarterly?
No. Banco de Mexico publishes municipal figures annually, covering 2,488 municipalities. State and national figures are available quarterly.
Can I use this data commercially?
Yes. The code is MIT licensed and the underlying statistics are public. Cite this dashboard and credit the original agencies: Banco de Mexico, INEGI, CONAPO and the US Census Bureau.
How do I connect an AI agent to the remittance data?
Install the MCP server from github.com/jp-pietrini/remittances-api-mcp with "claude mcp add remittances -- node /path/to/src/server.mjs". It exposes six tools covering coverage metadata, national totals, state and municipal rankings, single-state time series, and US states of origin.
Notes and citation
All amounts are in current USD. Mexican state and municipal figures come from Banco de México through the DataMexico cube and run to 2026-Q2. US state of origin figures come from the Banco de México SIE API and lag by a quarter or two, so the two sides of the corridor can end on different periods.
Municipal figures are annual. Annual totals for 2026 are partial until all four quarters are published, which is why charts here stop at 2025.
Citation: Pietrini, J.P. US-Mexico Remittances Dashboard. Available at remittances.mx. Please also credit Banco de México, INEGI, CONAPO and the US Census Bureau.