Skip to main content
Glama

acuris-mcp

Server Details

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

Status
Healthy
Last Tested
Transport
Streamable HTTP
URL
Repository
Acuris-GmbH/acuris-mcp
GitHub Stars
0

Glama MCP Gateway

Connect through Glama MCP Gateway for full control over tool access and complete visibility into every call.

MCP client
Glama
MCP server

Full call logging

Every tool call is logged with complete inputs and outputs, so you can debug issues and audit what your agents are doing.

Tool access control

Enable or disable individual tools per connector, so you decide what your agents can and cannot do.

Managed credentials

Glama handles OAuth flows, token storage, and automatic rotation, so credentials never expire on your clients.

Usage analytics

See which tools your agents call, how often, and when, so you can understand usage patterns and catch anomalies.

100% free. Your data is private.
Tool DescriptionsA

Average 4.5/5 across 8 of 8 tools scored.

Server CoherenceA
Disambiguation5/5

Each tool has a clear, distinct purpose: balance checking, single/batch validation, forward/reverse geocoding, UK postcode expansion, enrichment, and trial key request. No overlap that would cause confusion for an agent.

Naming Consistency5/5

All tool names follow a consistent verb_noun pattern with underscores (e.g., check_balance, validate_address, geocode_address). No mixed conventions or vague verbs.

Tool Count5/5

With 8 tools, the set is well-scoped for a geocoding/address validation API. It covers the essential operations without being too sparse or overly large.

Completeness4/5

The tool set covers core CRUD-like operations (validate, geocode, reverse geocode, batch) plus extras (balance, trial key, UK expansion). The enrich tool is slightly redundant with validate_address's built-in enrichment, but overall no significant gaps.

Available Tools

8 tools
check_balanceAInspect

Show the connected API key's remaining credit balances (validation, geocode, email, phone pools; trial expiry; the UK free-trial PAF counter for trial keys). Free — never consumes credits.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations present, but description discloses free, non-consumptive behavior and lists specific balances shown. It doesn't cover rate limits or authentication, but given zero parameters and simple nature, it's adequate.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Single sentence front-loads purpose, details specific pools, and states free usage. No wasted words.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

While it lists what balances are shown, it omits any description of the return format or structure. With no output schema, some guidance on response shape would improve completeness.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

No parameters exist, so schema coverage is 100%. The description adds context about what data is shown, which is useful despite no params.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool's purpose: showing remaining credit balances for multiple pools (validation, geocode, email, phone) and trial expiry. It distinguishes from sibling tools which are address/geocode related.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description implies use for checking balances but offers no explicit when-to-use vs alternatives. It does mention it's free and never consumes credits, which gives safety guidance but lacks explicit when-not.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

enrich_us_ca_addressAInspect

Address → census & geographic codes (USA + Canada), FREE with validation.

USA: state & county FIPS, census tract (11-digit GEOID), block group,
CBSA/MSA, congressional district (119th Congress), school district.
Canada: province, census division, dissemination area, census subdivision,
census tract, CMA/CA, federal electoral district. Sources: US Census
Bureau TIGER/Line; Statistics Canada (open data).

The enrichment is attached when the address resolves to a house-number- or
street-accurate match; centroid-only matches return no enrichment (the
point could fall in the wrong area). `country` must be "usa" or "can".

Cost: 1 validation credit (the enrichment itself is free); failed lookups
are refunded.
ParametersJSON Schema
NameRequiredDescriptionDefault
cityNo
stateNo
streetNo
countryYes
postcodeNo
address_lineNo
house_numberNo
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations were provided, so the description carries the full burden. It thoroughly discloses that enrichment is free but requires a validation credit, that failed lookups are refunded, and that only house-number- or street-accurate matches receive enrichment (centroid matches do not). It also names the data sources (US Census TIGER/Line, Statistics Canada), providing full transparency.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is well-structured with clear sections for USA and Canada codes, followed by important notes on matching and cost. Every sentence adds value: the first line introduces the function, the following lines enumerate returned codes, and the final lines explain conditions and cost. It is concise yet comprehensive.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the complexity of the tool (returns many geographic codes) and the absence of an output schema, the description does an excellent job of listing what codes are returned for each country. It also explains the conditions under which enrichment is attached and the cost model, leaving little ambiguity for an agent deciding whether to use this tool.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The input schema has 7 parameters but no descriptions (0% coverage). The description adds value by specifying that 'country must be 'usa' or 'can'', which imposes a constraint beyond the schema (which only marks country as required). It also explains that enrichment depends on match accuracy, which relates to the address fields. However, it does not detail individual parameters like city, state, or street format.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states that the tool enriches addresses with census and geographic codes for USA and Canada, listing specific codes for each country. It uses the verb 'enrich' which is specific to the resource (address → codes). It naturally distinguishes from sibling tools like geocode_address (which returns coordinates) and validate_address (which just checks validity).

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides clear guidance on when to use: when needing census/geographic codes for US or Canada. It specifies prerequisites (country must be 'usa' or 'can'), match accuracy requirements (house-number- or street-accurate only), and cost implications (validation credit, free enrichment, refunds). However, it does not explicitly mention when NOT to use or suggest alternatives for centroid-only cases.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

expand_uk_postcodeAInspect

Expand a UK postcode into every Royal Mail delivery point at that postcode — organisation, building, street, town, county, plus UDPRN, UPRN and rooftop coordinates for each address.

Cost: 1 credit per postcode, regardless of how many addresses come back;
an unknown/invalid postcode is refunded automatically.
ParametersJSON Schema
NameRequiredDescriptionDefault
postcodeYes
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description fully covers behavioral aspects: it discloses the cost (1 credit per postcode), refund for invalid postcodes, and the detailed output (fields including coordinates). This gives the agent a clear understanding of side effects and constraints.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is concise (two short paragraphs), front-loads the action and output, and every sentence adds value. No redundant or vague language.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

The description details the output fields (no output schema exists) and covers cost and refund policy. For a simple single-parameter tool, this provides all necessary context for an agent to use it correctly.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

There is only one parameter (postcode) with 0% schema description coverage. The description adds that it's a UK postcode, which is essential context. While minimal, it fully defines the parameter's meaning given the tool's simplicity.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool expands a UK postcode into Royal Mail delivery points, listing specific output fields (organisation, building, street, town, county, UDPRN, UPRN, coordinates). It distinguishes itself from sibling tools like geocode_address or validate_address through its specific function.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description explains cost and refund policy but does not explicitly state when to use this tool vs alternatives (e.g., validate_address). Context suggests it's for detailed address expansion, but no direct comparison or exclusions are provided.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

geocode_addressAInspect

Forward-geocode an address to coordinates (lat/lng) with an explicit accuracy_type (rooftop, street_interpolated, street_centroid, postcode_centroid, locality_centroid) — you always know what you got.

`country` is ISO-3 lowercase. Give fielded parts or a single line in `q`.
For UK (gbr) addresses use validate_address instead — it returns rooftop
coordinates from Royal Mail PAF.

Cost: 1 credit per successful geocode; failures are refunded.
ParametersJSON Schema
NameRequiredDescriptionDefault
qNo
cityNo
stateNo
streetNo
countryYes
postcodeNo
house_numberNo
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

While no annotations are provided, the description discloses key behavioral traits: returns coordinates with accuracy_type, credit cost per success, failure refunds, and ISO-3 country format. This adds value beyond what annotations would provide.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Description is concise yet comprehensive, front-loaded with purpose, followed by parameter guidance, sibling alternative, and cost. Every sentence adds value with no redundancy.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Completeness is high: covers purpose, parameters, usage context, return value (coordinates+accuracy), error handling (credits refunded), and sibling differentiation. No output schema needed given the description.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters5/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The input schema has 0% description coverage, but the description adds significant meaning: explains country format (ISO-3 lowercase), usage of fielded parts vs. q parameter, and notes that country is required. This fully compensates for the schema gap.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool's purpose: forward-geocode an address to coordinates with explicit accuracy_type. It distinguishes itself from sibling tools (e.g., validate_address for UK).

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Explicitly states when to use (geocoding with explicit accuracy), when not to use (UK addresses, use validate_address instead), and mentions cost and failure refunds.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

request_trial_keyAInspect

Get an instant FREE Acuris trial API key — 100 credits, valid 7 days, no card, no signup form. Idempotent: asking again with the same email within 24h returns the SAME key.

After receiving the key, reconfigure this MCP server connection with the
header "Authorization: Bearer <key>" (or set ACURIS_API_KEY for stdio).
Trial limits: shared per-IP daily caps and a lifetime cap of 40 UK (Royal
Mail PAF) lookups. Paid plans: https://www.acuris-geo.com/acuris-pricing/
ParametersJSON Schema
NameRequiredDescriptionDefault
emailYes
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Despite no annotations, the description discloses key behaviors: idempotency (same email within 24h), free credits, 7-day validity, per-IP caps, and 40 UK lookup lifetime cap. No contradictions.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Four sentences, front-loaded with main purpose, every sentence adds value. No unnecessary information.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given no output schema, no annotations, and one parameter, the description covers purpose, behavior, setup instructions, and limits. Complete for understanding tool usage.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters5/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The only parameter 'email' is clearly contextualized: the description explains it is used for idempotency and key association. With 0% schema coverage, the description fully compensates by adding meaning beyond the schema.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool gets an instant FREE Acuris trial API key, with specific details on credits, validity, and no card or signup. It distinguishes itself from sibling data enrichment tools.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Provides explicit guidance on when to use (getting a trial key), idempotency behavior, and post-receive steps (reconfiguring MCP server). Also mentions trial limits and paid plans, guiding appropriate usage.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

reverse_geocodeAInspect

Coordinates → nearest address(es). Returns the closest reference addresses to (lat, lng), nearest first, with distances.

Optional: `country` (ISO-3) to constrain the search, `radius_m`, `limit`.

Cost: 1 credit per successful lookup; an empty radius (no addresses found)
is refunded.
ParametersJSON Schema
NameRequiredDescriptionDefault
latYes
lngYes
limitNo
countryNo
radius_mNo
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Given no annotations, the description carries the burden. It adds cost info and refund for empty results, which is helpful. But it lacks details on error cases, output format, or limits, so only partial transparency.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Three sentences with no fluff. First sentence states core function, second lists optional params, third adds cost detail. Every sentence adds value and the structure is clear.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

With 5 parameters, no annotations, and no output schema, the description covers the main behavior and param roles but omits error handling, output structure details, and examples. It is adequate but not fully complete.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 0%, so the description must compensate. It explains lat/lng implicitly and gives context for optional parameters (country as ISO-3, radius_m with refund, limit). This adds significant meaning beyond the schema's bare titles and defaults.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool converts coordinates to nearest addresses, with ordering and distances. It distinguishes from siblings like geocode_address (forward geocoding) and validate_address (validation) by the task 'reverse geocode' and mention of coordinates.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description clearly indicates when to use (coordinates to address) and lists optional parameters to constrain search. However, it does not explicitly exclude use cases or contrast with sibling tools beyond the purpose.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

validate_addressAInspect

Validate and standardize one postal address (240+ countries; UK via the official Royal Mail PAF with UDPRN + UPRN).

Give `country` as ISO-3 lowercase (e.g. usa, can, deu, gbr) plus EITHER a
free-text `address_line` OR fielded parts (street, house_number, city,
state, postcode). Returns an honest verdict — status "verified" (exact) or
"corrected" (fixed), or partial_match with reasons — plus the standardized
form, confidence, coordinates with an explicit accuracy_type, and, for
street-accurate USA/Canada matches, a FREE `enrichment` block (census
tract, block group, FIPS, CBSA/MSA, congressional district, school
district / Canadian equivalents).

Cost: 1 validation credit per successful lookup; no-match and errors are
refunded automatically (you pay for results, not attempts).
ParametersJSON Schema
NameRequiredDescriptionDefault
cityNo
stateNo
streetNo
countryYes
postcodeNo
address_lineNo
house_numberNo
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations exist, so the description fully discloses behavior: honest verdict types (verified/corrected/partial_match), standardized form, confidence, coordinates with accuracy_type, and free enrichment for USA/Canada. It also details costing (1 credit per success, refunds for no-match/errors).

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is reasonably concise and well-structured, front-loading the purpose and then covering input, output, and cost. It could be slightly shorter, but every sentence adds value.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool has 7 parameters and no output schema, the description is remarkably complete: it covers input requirements, output format (verdict, standardized form, enrichment), cost model, and even country-specific details. Siblings like geocode_address and validate_addresses_batch provide further context.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 0%, so the description compensates by explaining the country format and the two input modes (address_line vs fielded parts). While it doesn't detail each parameter individually, it provides a clear overall usage pattern.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool validates and standardizes a single postal address, covering 240+ countries with specifics for UK Royal Mail PAF. It distinguishes from siblings like geocode_address and validate_addresses_batch by focusing on validation and standardization.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description explains when to use the tool (for single address validation) and how to provide input (country as ISO-3 lowercase, either address_line or fielded parts). It mentions cost and refund policy, aiding decision-making, but lacks explicit when-not-to-use guidance.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

validate_addresses_batchAInspect

Validate up to 50 addresses in one call (mixed countries allowed).

`addresses` is a list where each entry is either a free-text string, or an
object {"input": <string or fielded object>, "country": "iso3"}. Entries
without their own country use the `country` parameter. UK (gbr) rows are
routed individually to the Royal Mail PAF service; everything else goes
through the batch endpoint. Results come back in the same order, each with
the same shape as validate_address.

Cost: 1 validation credit per successfully validated row; failed rows are
refunded. For files bigger than 50 rows, call this tool repeatedly.
ParametersJSON Schema
NameRequiredDescriptionDefault
countryNo
addressesYes
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description fully carries the burden. It discloses cost (1 credit per success, refund on failure), ordering (same order as input), and routing logic (UK via Royal Mail PAF). No contradictions.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is efficient, using bullet-like formatting for the addresses parameter. However, it includes some redundancy (e.g., cost explained twice) and could be slightly tighter. Still well-structured and front-loaded.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given no output schema, the description explains return shape (same order, same as validate_address). It covers costs, limits, routing, and failure refunds. Highly complete for a batch tool with complex behavior.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 0%, but the description provides detailed structure for 'addresses' (free-text or object with 'input' and 'country'), and explains the 'country' parameter default. This adds significant meaning beyond the schema.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description uses a specific verb 'validate' and resource 'addresses_batch', clearly stating it handles up to 50 addresses per call with mixed countries. This distinguishes it from siblings like validate_address (single) and geocode_address.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Explicitly describes when to use (batch of ≤50 addresses) and when not (larger files: 'call this tool repeatedly'). Also notes routing differences for UK vs other addresses. However, it does not name an alternative for larger files beyond repetition.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Discussions

No comments yet. Be the first to start the discussion!

Try in Browser

Your Connectors

Sign in to create a connector for this server.