MCP Service Overview

MCP Service Features and Functions

Connect an MCP-compatible client to National Numbers registration lookup, formatting, transfer-requirement and valuation tools.

A1 MCP number plate
Service available
Streamable HTTP MCP transport
POST /

Overview

The National Numbers MCP service exposes vehicle registration functionality to MCP-compatible assistants, agents and developer tools.

The service uses the Model Context Protocol over Streamable HTTP. Your client discovers the available tools and invokes them using normal MCP requests sent to the service endpoint.

Authentication There is currently no requirement for Oauth or similar authentication, though this may be reviewed and changed in the future. This service is provided freely, subject to sensible usage limits.

Getting started

Add the service URL to an MCP client that supports Streamable HTTP.

{
  "mcpServers": {
    "national-numbers": {
      "type": "streamable-http",
      "url": "https://mcp.nationalnumbers.co.uk/"
    }
  }
}
Connect to Claude Install in VS Code

Once connected, the client should automatically discover the tools described below.

Connect National Numbers to ChatGPT

  1. Open Settings.
  2. Select Plugins.
  3. Select Developer mode.
  4. Enable Developer mode.
  5. Open Plugins.
  6. You should now see a + icon that will allow you to configure a custom Plugin, click it.
  7. Enter the following:
    Name: National Numbers
    Connection: https://mcp.nationalnumbers.co.uk/
    Authentication: No Auth

We're working hard to have this service approved as a qualified plugin to simplify it's installation!

Connect National Numbers to Hermes

Run this command:

hermes mcp add national-numbers --url https://mcp.nationalnumbers.co.uk/

Or add this to ~/.hermes/config.yaml:

mcp_servers:
national-numbers:
url: "https://mcp.nationalnumbers.co.uk/"

Available tools

suggest_registrations

Suggest matching registrations

Given a name, word, numbers or initials, intelligently suggests personalised number plates that make a good match. Optional filters for price, availability, plate format and vehicle age.

Personalised search Smart matching
lookup_registration

Look up one registration

Checks a UK registration and returns available format, age, year, region and explanatory information.

Single plate Lookup
Coming soon bulk_lookup_registrations

Look up several registrations

Performs registration lookups for a collection of up to 50 UK vehicle registrations.

1–50 plates Bulk lookup
format_registration

Format one registration

Returns the correct spacing and presentation for a UK vehicle registration.

Single plate Formatting
bulk_format_registration

Format several registrations

Correctly formats a collection of up to 50 vehicle registration marks.

1–50 plates Bulk formatting
transfer_requirements

Explain transfer requirements

Provides likely DVLA steps, vehicle eligibility, transfer or retention requirements and expected timescales.

DVLA guidance Transfer
value_registration

Estimate registration value

Returns an estimated market value, relevant valuation factors and available comparable registrations.

Valuation Comparables

Registration input rules

Rule Requirement
Length Between 2 and 8 characters.
Characters Letters, numbers and spaces only.
Letter case Input is trimmed and converted to uppercase automatically.
Bulk requests A minimum of 1 and maximum of 50 registrations per request.
Examples of accepted input F 1, S7 EVE, MY51 REG and A1 MCP.

Example prompts

Users normally interact with these tools through natural language rather than constructing JSON-RPC messages manually.

Look up the registration S7 EVE.

Format MY51REG correctly.

Check F 1, A1 MCP and S7 EVE and explain each plate.

What would be involved in transferring MY51 REG to my car?

Estimate the value of A 1 and explain the valuation factors.

Example tool arguments

{
  "registration": "MY51 REG"
}

Example bulk arguments

{
  "registrations": [
    "A 1",
    "S7 EVE",
    "MY51 REG"
  ]
}

Errors and troubleshooting

Problem Suggested action
Client cannot connect Confirm that the configured URL points to the MCP service root and uses HTTPS in production.
Invalid registration Check the character count and remove punctuation or unsupported symbols.
Tool returns no data Confirm the registration is correct and retry. The upstream service may not hold information for every query.
Internal server error Retry once. If the issue continues, contact the service administrator and include the approximate request time.

Frequently asked questions

Can I call the MCP endpoint from a browser?

A normal browser navigation makes a GET request, while the MCP service expects MCP traffic over HTTP. Use an MCP-compatible client to communicate with the endpoint.

Some widely used MCP-compatible clients include:

  • Claude Desktop - supports MCP servers and desktop extensions.
  • Visual Studio Code - supports local and remote MCP servers through its AI chat and agent features.
  • Cursor - supports MCP tools, data sources and server authentication.
  • Windsurf - supports MCP servers through Cascade and its plugin interface.
  • Zed - supports MCP tools and prompts within its AI features.
  • Hermes Agent - available as a desktop application for macOS and Windows.

Can I submit registrations without spaces?

Yes. The formatting tools can be used to determine the appropriate spacing for a supported UK registration, and all tools will first attempt to auto-correct any supplied registrations.

How many registrations can a bulk request contain?

Bulk lookup and formatting requests accept between 1 and 50 registrations.

Is a valuation a guaranteed sale price?

No. A valuation is an estimate based on the information and comparable registrations available when the request is made. For more information on valuations, please see the National Numbers free number plate valuation service.