{
  "markdown": "# Acuris Geo MCP Server\n\nGive any AI agent — Claude, Cursor, ChatGPT, Gemini CLI and every other\n[MCP](https://modelcontextprotocol.io)-capable client — direct, self-describing\naccess to **Acuris address validation and geocoding**: 240+ countries, honest\n`verified` / `corrected` / partial verdicts, UK addresses against the official\nRoyal Mail PAF (UDPRN + UPRN), and **free census & geographic enrichment** for\nstreet-accurate USA/Canada matches (census tract, block group, FIPS, CBSA/MSA,\ncongressional district, school district — Canadian equivalents included).\n\nThe server is a thin layer **on top of the Acuris REST API**: every tool call\nis billed, refunded and rate-limited exactly like the API call it wraps, under\n**your own API key**. Failed lookups are refunded automatically — you pay for\nresults, not attempts.\n\n## Quick start — hosted endpoint (recommended, zero install)\n\n**Claude Code**\n\n```bash\nclaude mcp add --transport http acuris-geo https://api.acuris-geo.com/mcp \\\n  --header \"Authorization: Bearer YOUR_ACURIS_API_KEY\"\n```\n\n**Claude Desktop / any JSON-config client**\n\n```json\n{\n  \"mcpServers\": {\n    \"acuris-geo\": {\n      \"type\": \"http\",\n      \"url\": \"https://api.acuris-geo.com/mcp\",\n      \"headers\": { \"Authorization\": \"Bearer YOUR_ACURIS_API_KEY\" }\n    }\n  }\n}\n```\n\n**Cursor** (`.cursor/mcp.json`)\n\n```json\n{ \"mcpServers\": { \"acuris-geo\": {\n    \"url\": \"https://api.acuris-geo.com/mcp\",\n    \"headers\": { \"Authorization\": \"Bearer YOUR_ACURIS_API_KEY\" } } } }\n```\n\n**No API key yet?** Connect without one and call the `request_trial_key` tool\nwith your email — you get an instant free trial key (100 credits, 7 days, no\ncard, no signup form). Then reconnect with the key.\n\n## Tools\n\n| Tool | What it does | Cost |\n|---|---|---|\n| `validate_address` | Validate & standardize one address (240+ countries; UK via Royal Mail PAF with UDPRN + UPRN). Street-accurate USA/Canada matches include the free census enrichment block. | 1 credit |\n| `validate_addresses_batch` | Up to 50 addresses per call, mixed countries. Results in input order. | 1 credit / row |\n| `enrich_us_ca_address` | Address → census tract, block group, county/state FIPS, CBSA/MSA, congressional district, school district (USA) / dissemination area, census division, CMA/CA, federal electoral district (Canada). | 1 credit (enrichment free) |\n| `geocode_address` | Forward geocoding with an explicit `accuracy_type` on every result. | 1 credit |\n| `reverse_geocode` | Coordinates → nearest addresses with distances. | 1 credit |\n| `expand_uk_postcode` | UK postcode → every Royal Mail delivery point (organisation, UDPRN, UPRN, rooftop coordinates). | 1 credit / postcode |\n| `check_balance` | Remaining credit balances for the connected key. | free |\n| `request_trial_key` | Instant free trial key by email (idempotent for 24h). | free |\n\nNo-match and error responses are **refunded automatically**.\n\n## Local (stdio) mode\n\n```bash\npip install acuris-mcp        # or: uvx acuris-mcp --stdio\nACURIS_API_KEY=YOUR_KEY acuris-mcp --stdio\n```\n\nClaude Desktop stdio config:\n\n```json\n{\n  \"mcpServers\": {\n    \"acuris-geo\": {\n      \"command\": \"uvx\",\n      \"args\": [\"acuris-mcp\", \"--stdio\"],\n      \"env\": { \"ACURIS_API_KEY\": \"YOUR_KEY\" }\n    }\n  }\n}\n```\n\nSame tools, same billing. The hosted endpoint is recommended — zero install\nand always current.\n\n## Docs & links\n\n- Full MCP docs: https://api.acuris-geo.com/docs/mcp\n- REST API reference: https://api.acuris-geo.com/docs\n- Pricing: https://www.acuris-geo.com/acuris-pricing/\n- US/Canada enrichment: https://www.acuris-geo.com/us-canada-address-enrichment/\n- Excel add-in (same engine, no code): https://www.acuris-geo.com/excel-add-in/\n\n## License\n\nMIT (this connector). The Acuris API itself is a commercial service —\nsee the [terms](https://api.acuris-geo.com/docs/legal-terms).\n",
  "bytes": 3819,
  "sha": "2ab0da0a8db111b40146f48d00cef2a32ce26d03b0c537411de9e048b19e158e",
  "repo_slug": "acuris-gmbh/acuris-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_com_acuris_geo_acuris_mcp_3f1004d0/readme"
}