English Français العربية

com.acuris-geo/acuris-mcp

السجل الرسمي الذكاء الاصطناعي والوكلاء

Address validation & geocoding for AI agents: 240+ countries, UK PAF, free US/CA enrichment

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http acuris-mcp 'https://api.acuris-geo.com/mcp' --header 'Authorization: <Bearer <your Acuris API key> — get a free trial key via the request_trial_key tool or https://www.acuris-geo.com/acuris-pricing/>'
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "acuris-mcp": {
            "type": "http",
            "url": "https://api.acuris-geo.com/mcp",
            "headers": {
                "Authorization": "<Bearer <your Acuris API key> — get a free trial key via the request_trial_key tool or https://www.acuris-geo.com/acuris-pricing/>"
            }
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. Acuris Geo MCP Server
  2. Quick start — hosted endpoint (recommended, zero install)
  3. Tools
  4. Local (stdio) mode
  5. Docs & links
  6. License

Acuris Geo MCP Server

Give any AI agent — Claude, Cursor, ChatGPT, Gemini CLI and every other MCP-capable client — direct, self-describing access to Acuris address validation and geocoding: 240+ countries, honest verified / corrected / partial verdicts, UK addresses against the official Royal Mail PAF (UDPRN + UPRN), and free census & geographic enrichment for street-accurate USA/Canada matches (census tract, block group, FIPS, CBSA/MSA, congressional district, school district — Canadian equivalents included).

The server is a thin layer on top of the Acuris REST API: every tool call is billed, refunded and rate-limited exactly like the API call it wraps, under your own API key. Failed lookups are refunded automatically — you pay for results, not attempts.

Claude Code

claude mcp add --transport http acuris-geo https://api.acuris-geo.com/mcp \
  --header "Authorization: Bearer YOUR_ACURIS_API_KEY"

Claude Desktop / any JSON-config client

{
  "mcpServers": {
    "acuris-geo": {
      "type": "http",
      "url": "https://api.acuris-geo.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_ACURIS_API_KEY" }
    }
  }
}

Cursor (.cursor/mcp.json)

{ "mcpServers": { "acuris-geo": {
    "url": "https://api.acuris-geo.com/mcp",
    "headers": { "Authorization": "Bearer YOUR_ACURIS_API_KEY" } } } }

No API key yet? Connect without one and call the request_trial_key tool with your email — you get an instant free trial key (100 credits, 7 days, no card, no signup form). Then reconnect with the key.

Tools

ToolWhat it doesCost
validate_addressValidate & 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
validate_addresses_batchUp to 50 addresses per call, mixed countries. Results in input order.1 credit / row
enrich_us_ca_addressAddress → 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)
geocode_addressForward geocoding with an explicit accuracy_type on every result.1 credit
reverse_geocodeCoordinates → nearest addresses with distances.1 credit
expand_uk_postcodeUK postcode → every Royal Mail delivery point (organisation, UDPRN, UPRN, rooftop coordinates).1 credit / postcode
check_balanceRemaining credit balances for the connected key.free
request_trial_keyInstant free trial key by email (idempotent for 24h).free

No-match and error responses are refunded automatically.

Local (stdio) mode

pip install acuris-mcp        # or: uvx acuris-mcp --stdio
ACURIS_API_KEY=YOUR_KEY acuris-mcp --stdio

Claude Desktop stdio config:

{
  "mcpServers": {
    "acuris-geo": {
      "command": "uvx",
      "args": ["acuris-mcp", "--stdio"],
      "env": { "ACURIS_API_KEY": "YOUR_KEY" }
    }
  }
}

Same tools, same billing. The hosted endpoint is recommended — zero install and always current.

License

MIT (this connector). The Acuris API itself is a commercial service — see the terms.

الأسئلة الشائعة

ما هو com.acuris-geo/acuris-mcp؟

Address validation & geocoding for AI agents: 240+ countries, UK PAF, free US/CA enrichment

كيف أثبّت com.acuris-geo/acuris-mcp؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http acuris-mcp 'https://api.acuris-geo.com/mcp' --header 'Authorization: <Bearer <your Acuris API key> — get a free trial key via the request_trial_key tool or https://www.acuris-geo.com/acuris-pricing/>'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج com.acuris-geo/acuris-mcp إلى مفتاح API؟

نعم. يتطلب Authorization، وتضبطها في إعداداته.

هل com.acuris-geo/acuris-mcp مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون com.acuris-geo/acuris-mcp؟

ينشره Acuris-GmbH. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.