Acuris for AI coding agents

Your AI assistant should get address validation right the first time.

Install the Acuris agent context once. Claude Code, Cursor, GitHub Copilot, Codex, OpenCode, Gemini CLI, Kiro, Goose — they all get the actual SDK shape, the right headers, the typed error hierarchy, and a library of recipes. No more hallucinated endpoints. No more Authorization: Bearer on the wrong header. No more invisible dropdowns in Tailwind v4.

Install the skill View on GitHub

NEW — MCP server: live tools, not just context

The Agent Skill below teaches your AI tool to write code against the Acuris API. The MCP server goes further: it gives any MCP-capable client — Claude, Cursor, ChatGPT, Gemini CLI — live, self-describing tools it can call directly: validate an address, geocode, expand a UK postcode, pull US/Canada census enrichment. Billing runs under your own API key, exactly like the API; failed lookups are refunded automatically. An agent without a key can even self-provision a free trial key via the request_trial_key tool.

Claude Code

Hosted endpoint — zero install.

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

Any MCP client (JSON config)

Claude Desktop, Cursor, and 30+ others.

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

Tool reference, auth and billing: api.acuris-geo.com/docs/mcp · source & stdio package: github.com/Acuris-GmbH/acuris-mcp

Two skills, one install

The package bundles two model-invoked skills. Each auto-activates only when your task matches its area, so installing both costs almost no context.

acuris-address

Address Validation & Geocoding

Wires @acuris-geo/av-sdk + @acuris-geo/centra-checkout into your project — validation, forward and reverse geocoding, autocomplete, batch cleanup, Next.js proxy routes, plain Node servers.

  • Centra / commercetools / SCAYLE storefront integrations
  • Migration recipes for Loqate, libAddressDoctor (Informatica), Experian, Smarty
  • Free dev key flow (no signup form)

acuris-eudi

EUDI Wallet Verifier

Wires the Acuris EUDI Wallet Verifier (OID4VP / SD-JWT VC at eudi.acuris-geo.com) into a bank KYC or onboarding flow — session initiation, polling, trust validation against EU 27 member-state TSLs.

  • Relying-party backend in Node, Python, Go
  • Result handling: Verified / Corrected / Partial / Unverified buckets
  • mTLS pilot setup, audit-trail compliance

Install

Pick the install path that matches your AI tool. The skill content is identical across all of them.

Claude Code

Self-hosted marketplace today. Official Anthropic marketplace listing pending review.

/plugin marketplace add Acuris-GmbH/acuris-agent-context /plugin install acuris@acuris-plugins

Cursor

Native Agent Skills support. Or drop the MDC rules into .cursor/rules/.

npx skills add Acuris-GmbH/acuris-agent-context -a cursor

GitHub Copilot · Codex · OpenCode

Plus Gemini CLI, Kiro, Goose, and ~30 other tools listed at agentskills.io.

npx skills add Acuris-GmbH/acuris-agent-context # interactive picker — choose your agent

Any other LLM

Point your client at the canonical SKILL.md and the references library.

git clone https://github.com/Acuris-GmbH/acuris-agent-context # skills/acuris-address/SKILL.md + references/*.md

What your assistant gets right

Without the skill, AI assistants hallucinate endpoints, hand-roll fetch calls with the wrong auth header, and guess at npm versions that don't exist. With the skill installed, the assistant knows:

The actual SDK shape

Four endpoints (validate, geocode, reverse, suggest), X-Acuris-Key header, ISO-3 lowercase country codes, typed error hierarchy with automatic retries on 5xx / 429 / network / timeout.

The current npm versions

Pinned to @acuris-geo/av-sdk@^0.1.2 and @acuris-geo/centra-checkout@^0.1.2. No more ^1.0.0 guesses that fail npm install.

The proxy-route pattern

API key stays server-side. Browser calls /api/acuris/* on your backend, which uses the SDK to talk to Acuris. Drop-in routes for Next.js App Router, Pages Router, Express, Fastify, Cloudflare Workers.

Component prop names

minQueryLength, not minLength. renderSuggestion for custom rows. suggestionsClassName for the dropdown. Visible defaults in 0.1.2 so the dropdown renders in Tailwind v4 environments out of the box.

The country-coverage caveats

Autocomplete works for 7 countries (US, UK, DE, NL, FI, SE, JP) — the skill omits unsupported countries from typeahead pickers automatically. Validation and geocoding work for 200+ ISO-3 codes; UK validation runs on Royal Mail PAF with UDPRN/UPRN.

Migration recipes

Replace your libAddressDoctor (Informatica), Loqate, Experian, or Smarty calls with one Acuris call. Status-code mappings, field translations, and the parts that don't migrate (CASS certifications, vendor-specific stable IDs) all called out.

What to type into your AI tool

Anything in this list activates the right recipe automatically. The skill's frontmatter triggers on these keywords.

Build an address autocomplete component for my Next.js checkout form → scaffolds a React component, the country picker (typeahead-enabled set), and the proxy route that keeps the API key server-side.
Validate this customer's shipping address before I save the order → wires validateAddress into your server route with the typed error hierarchy handled distinctly.
Add reverse geocoding from a GPS fix to the nearest known address → scaffolds /api/acuris/reverse, an escalating-radius pattern (50m → 200m → 1000m), and the result UI.
Run a batch validation pass over my dirty addresses table → writes a Node script with concurrency 8-16, the right retry budget for long jobs, resumable JSONL output, and quality bucketing.
Wire EUDI Wallet verification into my bank KYC flow → scaffolds POST /v1/eudi/sessions, the QR display, the polling loop, and the verification_status + accuracy_type → KYC decision routing.

Get a free dev key in one call

No signup form. No email round-trip. A free 100-validation + 100-geocode key valid for 7 days, returned directly in the response body. The skill teaches the assistant to do this for you automatically — but you can also run it yourself:

curl -X POST https://api.acuris-geo.com/dev-key \ -H 'Content-Type: application/json' \ -d '{"email":"you@example.com"}' # → {"api_key":"...", "validation_credits":100, "geocode_credits":100, "expires_at":"..."}

For higher caps, the 28-day trial (1000 + 1000 credits) and paid plans remain. The dev key authenticates the same endpoints as a paid one — it's the same auth path, just rate-limited.

Status

Self-hosted marketplace: available now. The Claude Code install command above works today against Acuris-GmbH/acuris-agent-context.

Official Anthropic marketplace: submitted 2026-05-17, awaiting review. Once approved, the install command shortens to /plugin install acuris@claude-plugins-official.

Cursor & the `npx skills add` ecosystem: available now. The skill is in the canonical Anthropic Agent Skills format, which Cursor and 30+ other tools consume natively via agentskills.io.

Source & docs