{
  "markdown": "# Synergic APIs — MCP Server\n\nOfficial [Model Context Protocol](https://modelcontextprotocol.io) server for\n[Synergic APIs](https://synergicapis.com): official US economic data for AI\nagents. It gives Claude, Cursor, and any MCP-capable client direct access to:\n\n- **US Inflation API** — the official CPI-U from the Bureau of Labor Statistics:\n  11 categories, YoY/MoM rates computed like the BLS, monthly history back to\n  **1913**, official annual averages.\n- **Famous prices** — US average price of eggs, gasoline, milk, bread, ground\n  beef, coffee and electricity, monthly since 1976.\n- **US National Debt API** — the U.S. Treasury debt to the penny, every business\n  day since 1993, annual debt outstanding since **1790**, and the average\n  interest rates the Treasury pays.\n\nAll amounts are JSON numbers, periods are `YYYY-MM` / `YYYY-MM-DD`, and missing\nmonths in the official record are served as `null` — never invented.\n\n## Requirements\n\n- Node.js 18.17+ (`npx` included).\n- A Synergic APIs key. **Get one free (no credit card) at\n  [synergicapis.com/signup.html](https://synergicapis.com/signup.html)** —\n  500 requests/month, both APIs, full history. Paid plans at\n  [synergicapis.com/pricing.html](https://synergicapis.com/pricing.html).\n\n## Installation\n\nThe server runs over stdio via `npx` — no clone, no build.\n\n### Claude Desktop\n\nAdd to `claude_desktop_config.json` (Settings → Developer → Edit Config):\n\n```json\n{\n  \"mcpServers\": {\n    \"synergic-apis\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@synergic-apis/mcp\"],\n      \"env\": {\n        \"SYNERGIC_API_KEY\": \"YOUR_API_KEY\"\n      }\n    }\n  }\n}\n```\n\n### Claude Code\n\n```bash\nclaude mcp add synergic-apis --env SYNERGIC_API_KEY=YOUR_API_KEY -- npx -y @synergic-apis/mcp\n```\n\n### Cursor\n\nAdd to `~/.cursor/mcp.json` (or `.cursor/mcp.json` in your project):\n\n```json\n{\n  \"mcpServers\": {\n    \"synergic-apis\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@synergic-apis/mcp\"],\n      \"env\": {\n        \"SYNERGIC_API_KEY\": \"YOUR_API_KEY\"\n      }\n    }\n  }\n}\n```\n\n### Configuration\n\n| Variable | Required | Default | Description |\n| --- | --- | --- | --- |\n| `SYNERGIC_API_KEY` | yes | — | Your API key. Sent as `X-Api-Key` on every request. |\n| `SYNERGIC_GATEWAY_URL` | no | `https://api.synergicapis.com` | Gateway base URL (override for testing). |\n\n## Tools\n\n| Tool | What it does | Key arguments |\n| --- | --- | --- |\n| `get_us_inflation_latest` | Latest month of CPI for all 11 categories with YoY/MoM rates. | `adjusted` (optional) |\n| `get_us_inflation_history` | Monthly CPI history of one category (headline since 1913). | `category`, `start`/`end` (`YYYY-MM`), `limit` (≤100), `adjusted` |\n| `get_us_inflation_annual` | Official annual average CPI (M13, NSA). `limit=150` = whole headline series. | `category`, `start`/`end` (`YYYY`), `limit` (≤150) |\n| `get_famous_prices` | Latest basket of famous US prices, or one item's monthly history. | `item` (optional), `start`/`end` (`YYYY-MM`), `limit` (≤100) |\n| `get_us_debt_latest` | The US national debt today, to the penny. | — |\n| `get_us_debt_history` | Daily debt (1993+, limit ≤100) or annual fiscal-year-end debt (1790+, `limit=250` = whole series). | `frequency` (`daily`/`annual`), `start`/`end` (`YYYY-MM-DD`), `limit` |\n| `get_us_interest_rates` | Latest Treasury avg interest rate per security class, or one class's monthly history (2001+). | `security_class` (optional), `start`/`end` (`YYYY-MM-DD`), `limit` (≤100) |\n| `get_my_usage` | Plan, requests used, monthly limit and reset date of your key. | — |\n\nHistory tools paginate by period range: when a response's `meta.next_end` is not\n`null`, call the tool again with `end` set to that value to get older data.\n\n## Try it\n\nAsk your assistant things like:\n\n- *\"What is US inflation right now, headline and core?\"*\n- *\"Plot the price of eggs since 2020.\"*\n- *\"How much did the US national debt grow in the last 12 months?\"*\n- *\"What rate does the Treasury pay on T-bills today vs 2021?\"*\n\n## Troubleshooting\n\n- **\"SYNERGIC_API_KEY is not set\"** — the server exits at startup if the key is\n  missing. Add it to the `env` block of your MCP client config (see above) and\n  restart the client.\n- **\"Invalid API key\"** — the gateway rejected the key (typo or revoked). Keys\n  look like `sk_...`. Get a fresh one at\n  [synergicapis.com/signup.html](https://synergicapis.com/signup.html).\n- **\"Rate limit exceeded … retry after Xs\"** — you hit your plan's per-minute\n  limit (free: 10 req/min). Wait and retry.\n- **\"Monthly quota exhausted\"** — you used the month's requests (free: 500).\n  Ask the agent to call `get_my_usage` for details, wait for the 1st (UTC), or\n  upgrade at [synergicapis.com/pricing.html](https://synergicapis.com/pricing.html).\n- **Tools don't appear in the client** — check the client's MCP logs; the most\n  common causes are an old Node (needs 18.17+) or `npx` not on the PATH used by\n  the client. Running `npx -y @synergic-apis/mcp` in a terminal should print\n  `ready on stdio` to stderr and then wait for input.\n- **Corporate proxy / self-hosted testing** — point `SYNERGIC_GATEWAY_URL` at\n  your gateway; the server only ever issues GET requests with `X-Api-Key`.\n\n## Development\n\n```bash\nnpm install\nnpm run typecheck   # tsc --noEmit (strict)\nnpm test            # vitest — tool→request mapping + error mapping, fetch mocked\nnpm run build       # emits dist/ and the synergic-apis-mcp bin\n```\n\n## Data sources & license\n\nData: U.S. Bureau of Labor Statistics and U.S. Treasury Fiscal Data (public\ndomain; this product is not endorsed by or affiliated with either agency).\nCode: MIT.\n",
  "bytes": 5603,
  "sha": "8aebc926603f8893a638f1816bb7a67be7067ce072af66820ea24593a7510d62",
  "repo_slug": "synergic-apis/mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_synergic_apis_mcp_b5862f91/readme"
}