Addresspenny for Claude and MCP — Addresspenny

What is MCP?

The Model Context Protocol is an open standard for giving LLMs access to external tools. Claude Desktop, Cursor, and a growing list of AI applications use it to call third-party services directly from a chat. The @addresspenny/mcp server exposes Addresspenny's validation engine as three tools your agent can call — no glue code required.

Three tools, one install

Each address validated costs one credit. Same as the REST API — no separate AI surcharge.

validate_address

Validate a single postal address. Returns standardized components, deliverability, and granularity metadata.

bulk_validate

Validate up to 100 addresses in a single call. Ideal when the agent already has a structured list.

parse_and_validate

Pull postal addresses out of freeform text — emails, chat messages, transcripts — and validate each one.

60-second setup

Paste a URL, sign in, done.

Claude Desktop — remote connector

The fastest path. Paste the URL below into Settings → Connectors → Add Custom Connector. Claude Desktop handles OAuth; you sign in with your Addresspenny account, pick which team to use, and tools appear instantly. No API token handling, no Node install.

https://addresspenny.com/mcp

Open the MCP setup page in your developer dashboard for a pre-filled URL and step-by-step instructions.

Claude Desktop — Desktop Extension

Prefer running locally? Download the Desktop Extension instead. Claude Desktop prompts for your API token and account ID in a dialog.

Download for Claude Desktop

Cursor

One-click install. Cursor opens, you paste your API token, and you're done.

Add to Cursor

Manual config (fallback)

Prefer to edit the config file yourself? Add this block to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "addresspenny": {
      "command": "npx",
      "args": ["-y", "@addresspenny/mcp"],
      "env": {
        "ADDRESSPENNY_API_KEY": "your-api-token",
        "ADDRESSPENNY_ACCOUNT_ID": "acct_..."
      }
    }
  }
}

Fully quit and reopen Claude Desktop. Addresspenny tools appear under the tools icon in the chat input. For Cursor without the deep link, add the same block to ~/.cursor/mcp.json and restart.

Want the snippet pre-filled with your credentials? Open the MCP setup page in your developer dashboard.

What you can ask

Natural language, straight into your agent.

"Validate this address: 1600 Amphitheatre Pkwy, Mountain View CA."
"Pull every address out of this email thread and check which ones are deliverable."
"Here's a list of 50 customer addresses — standardize them and flag the ones that failed."
"I'm drafting a shipping label — make sure this address is valid before I print it."

Links

@addresspenny/mcp on npm GitHub MCP developer guide REST API reference

Address validation for AI agents