{"_id":"@addresspenny/mcp","_rev":"3-6be6158c7e02e6c4311a79c74333b365","name":"@addresspenny/mcp","dist-tags":{"latest":"0.1.4"},"versions":{"0.1.0":{"name":"@addresspenny/mcp","version":"0.1.0","keywords":["mcp","model-context-protocol","address","address-validation","addresspenny"],"license":"MIT","_id":"@addresspenny/mcp@0.1.0","maintainers":[{"name":"mcrundo","email":"contact@laddster.com"}],"homepage":"https://addresspenny.com","bugs":{"url":"https://github.com/CanalWestStudio/addresspenny-mcp/issues"},"bin":{"addresspenny-mcp":"build/index.js"},"dist":{"shasum":"56559c0a38324f53cfee303346cf55256487214c","tarball":"https://registry.npmjs.org/@addresspenny/mcp/-/mcp-0.1.0.tgz","fileCount":5,"integrity":"sha512-4v/lzgd1RAdb/MfPe8zDSR1nVEH1STkLhISOMgkAi+l/nAcdqUIeRJiHAdcQGHUWY0WBR2di+DMmbFnmO0JOMQ==","signatures":[{"sig":"MEUCIFCvDJ7VV7TR2dFLwgSd667hYrDat0gM2aAhTHa/MIaFAiEAnF6hDxF9HJe/GYZtmRrxgD/XEvG+rngJeH2bmhsCuIQ=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":10242},"type":"module","engines":{"node":">=18"},"gitHead":"c5b2ce991731c5679634f411be397d53ffa556e6","scripts":{"build":"tsc && chmod 755 build/index.js","start":"node build/index.js","typecheck":"tsc --noEmit","prepublishOnly":"npm run build"},"_npmUser":{"name":"mcrundo","email":"contact@laddster.com"},"repository":{"url":"git+https://github.com/CanalWestStudio/addresspenny-mcp.git","type":"git"},"_npmVersion":"11.3.0","description":"Model Context Protocol server for AddressPenny address validation","directories":{},"_nodeVersion":"24.1.0","dependencies":{"zod":"^3.23.0","@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.5.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp_0.1.0_1776218075298_0.5702958585374891","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@addresspenny/mcp","version":"0.1.1","keywords":["mcp","model-context-protocol","address","address-validation","addresspenny"],"license":"MIT","_id":"@addresspenny/mcp@0.1.1","maintainers":[{"name":"mcrundo","email":"contact@laddster.com"}],"homepage":"https://addresspenny.com","bugs":{"url":"https://github.com/CanalWestStudio/addresspenny-mcp/issues"},"bin":{"addresspenny-mcp":"build/index.js"},"dist":{"shasum":"8205c6206ef54089a05b9b5655bab51219ef0ad4","tarball":"https://registry.npmjs.org/@addresspenny/mcp/-/mcp-0.1.1.tgz","fileCount":6,"integrity":"sha512-kISm8GsGNR8q7rOpaxTrxCWH35GzHwtD/9WomPFSZW+uAR2argkg6HoMsds2oKgLMg151AU13ONO1CSDV/2aNg==","signatures":[{"sig":"MEUCIAdjgwSSVtHZ3nuG2G/anv0MQcPVo8Zj0gjkM/ypH0K2AiEAv4pMkwaJbBP9+Fi2EWKKrk6aw6bp2PH1X4Bj6HcZ5Ro=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":11678},"type":"module","engines":{"node":">=18"},"gitHead":"ca010b706600040bd89148ef3cfc4f792ef0b8d6","scripts":{"build":"tsc && chmod 755 build/index.js","start":"node build/index.js","typecheck":"tsc --noEmit","prepublishOnly":"npm run build"},"_npmUser":{"name":"mcrundo","email":"contact@laddster.com"},"repository":{"url":"git+https://github.com/CanalWestStudio/addresspenny-mcp.git","type":"git"},"_npmVersion":"11.3.0","description":"Model Context Protocol server for AddressPenny address validation","directories":{},"_nodeVersion":"24.1.0","dependencies":{"zod":"^3.23.0","@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.5.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp_0.1.1_1776220237738_0.40535225452079593","host":"s3://npm-registry-packages-npm-production"}},"0.1.4":{"name":"@addresspenny/mcp","version":"0.1.4","description":"Model Context Protocol server for Addresspenny address validation","type":"module","bin":{"addresspenny-mcp":"build/index.js"},"scripts":{"build":"tsc && chmod 755 build/index.js","start":"node build/index.js","typecheck":"tsc --noEmit","pack:dxt":"node scripts/build-dxt.mjs","prepublishOnly":"npm run build"},"dependencies":{"@modelcontextprotocol/sdk":"^1.0.0","zod":"^3.23.0"},"devDependencies":{"@anthropic-ai/dxt":"^0.2.6","@types/node":"^22.0.0","typescript":"^5.5.0"},"engines":{"node":">=18"},"keywords":["mcp","model-context-protocol","address","address-validation","addresspenny"],"repository":{"type":"git","url":"git+https://github.com/CanalWestStudio/addresspenny-mcp.git"},"homepage":"https://addresspenny.com","license":"MIT","_id":"@addresspenny/mcp@0.1.4","gitHead":"08458556728fb613504053e838c908c1cc8c8b63","bugs":{"url":"https://github.com/CanalWestStudio/addresspenny-mcp/issues"},"_nodeVersion":"24.1.0","_npmVersion":"11.3.0","dist":{"integrity":"sha512-k9fTuqM023CJlH4PPAsI4jPvQudR8/HALV8qXSeK8WgixkXNgXwYpleqnF0ntYYHi4Vkw2WWXP9kWy0RNcyLEA==","shasum":"c45396f842448375151fcaee13b9e1ffc076a122","tarball":"https://registry.npmjs.org/@addresspenny/mcp/-/mcp-0.1.4.tgz","fileCount":6,"unpackedSize":11759,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIDvsimXcLrDpAypPuqeXBqEwKEwmlO81rz7PUdfcn2j3AiEA2KET1RbnAoI9OPR5GGzU9XDBQWB49IEUqcJarbFTSRE="}]},"_npmUser":{"name":"mcrundo","email":"contact@laddster.com"},"directories":{},"maintainers":[{"name":"mcrundo","email":"contact@laddster.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp_0.1.4_1776228949487_0.596165847378856"},"_hasShrinkwrap":false}},"time":{"created":"2026-04-15T01:54:35.217Z","modified":"2026-04-15T04:55:49.771Z","0.1.0":"2026-04-15T01:54:35.469Z","0.1.1":"2026-04-15T02:30:37.919Z","0.1.4":"2026-04-15T04:55:49.640Z"},"bugs":{"url":"https://github.com/CanalWestStudio/addresspenny-mcp/issues"},"license":"MIT","homepage":"https://addresspenny.com","keywords":["mcp","model-context-protocol","address","address-validation","addresspenny"],"repository":{"type":"git","url":"git+https://github.com/CanalWestStudio/addresspenny-mcp.git"},"description":"Model Context Protocol server for Addresspenny address validation","maintainers":[{"name":"mcrundo","email":"contact@laddster.com"}],"readme":"# @addresspenny/mcp\n\n[Model Context Protocol](https://modelcontextprotocol.io) server for [Addresspenny](https://addresspenny.com) address validation. Lets Claude Desktop, Cursor, and any MCP-compatible agent validate postal addresses, bulk-clean lists, and extract addresses from freeform text.\n\n## Tools\n\n- **`validate_address`** — validate a single postal address. Returns the standardized address and validation metadata. Consumes 1 credit.\n- **`bulk_validate`** — validate up to 100 addresses in one call. Consumes 1 credit per address.\n- **`parse_and_validate`** — extract every postal address from unstructured text (chats, transcripts, scraped pages) and validate each one. Consumes 1 credit per extracted and validated address.\n\n## Requirements\n\n- Node.js 18 or newer\n- An Addresspenny account with an API token and the token's account ID — create both at [addresspenny.com](https://addresspenny.com)\n\n## Configuration\n\nThe server reads three environment variables:\n\n| Variable | Required | Default | Notes |\n| --- | --- | --- | --- |\n| `ADDRESSPENNY_API_KEY` | yes | — | API token from Addresspenny |\n| `ADDRESSPENNY_ACCOUNT_ID` | yes | — | Prefixed account ID (e.g. `acct_abc123`) |\n| `ADDRESSPENNY_API_URL` | no | `https://addresspenny.com/api/v1` | Override for self-hosted or staging |\n\n## Claude Desktop\n\nEdit `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or the equivalent on your OS:\n\n```json\n{\n  \"mcpServers\": {\n    \"addresspenny\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@addresspenny/mcp\"],\n      \"env\": {\n        \"ADDRESSPENNY_API_KEY\": \"your-api-token\",\n        \"ADDRESSPENNY_ACCOUNT_ID\": \"acct_your_account_id\"\n      }\n    }\n  }\n}\n```\n\nRestart Claude Desktop. The tools appear under the tools icon in the chat input.\n\n## Cursor\n\nAdd to `~/.cursor/mcp.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"addresspenny\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@addresspenny/mcp\"],\n      \"env\": {\n        \"ADDRESSPENNY_API_KEY\": \"your-api-token\",\n        \"ADDRESSPENNY_ACCOUNT_ID\": \"acct_your_account_id\"\n      }\n    }\n  }\n}\n```\n\n## Local development\n\n```bash\nnpm install\nnpm run build\nADDRESSPENNY_API_KEY=... ADDRESSPENNY_ACCOUNT_ID=... node build/index.js\n```\n\nThe server speaks MCP over stdio. It is not meant to be invoked directly — point an MCP client at it using the config above.\n\n## License\n\nMIT\n","readmeFilename":"README.md"}