{"_id":"@abmdev/mcp","_rev":"2-fa7636755a70a2f18400e31cf7868fce","name":"@abmdev/mcp","dist-tags":{"latest":"0.1.1"},"versions":{"0.1.0":{"name":"@abmdev/mcp","version":"0.1.0","keywords":["mcp","enrichment","abm","b2b-data","ai-agents"],"author":{"url":"abm.dev","name":"Foxley Farm Operations Ltd"},"license":"MIT","_id":"@abmdev/mcp@0.1.0","maintainers":[{"name":"smcleodau","email":"stuart@heyarchie.ai"}],"homepage":"https://abm.dev","bugs":{"url":"https://abm.dev"},"bin":{"abm-mcp":"bin/abm-mcp.mjs"},"dist":{"shasum":"eb30ee22d1200a2ed323faee3111e07b985b8b64","tarball":"https://registry.npmjs.org/@abmdev/mcp/-/mcp-0.1.0.tgz","fileCount":5,"integrity":"sha512-s0RTzj0osxGxp3lNSdk8994VjVGEOT9r+wfyGbF3923FAV6qsDmKi2CtNd/a3pXsLi61oUko+8rkdXasO3NbkQ==","signatures":[{"sig":"MEYCIQDg7tAekYk3sckP4RWJFtU/0i6OP51BmuHfw9cPcvyOagIhAO4fRSK/m1Bi2GpHrYSmJBeftlIE2IYixwG8A7CFl176","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":10477},"type":"module","engines":{"node":">=18"},"gitHead":"0e3610be12a30eeadd0698328cf337858350506b","mcpName":"io.github.abm-dev-git/abm-mcp","_npmUser":{"name":"smcleodau","email":"stuart@heyarchie.ai"},"repository":{"url":"git+https://github.com/abm-dev-git/abm-mcp.git","type":"git"},"_npmVersion":"10.9.4","description":"Thin local bridge to the hosted abm.dev MCP server — B2B enrichment for AI agents. Proxies stdio to https://mcp.abm.dev/mcp with OAuth 2.1 PKCE.","directories":{},"_nodeVersion":"22.21.0","dependencies":{"mcp-remote":"0.1.38"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/mcp_0.1.0_1781019579134_0.18446866712768606","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@abmdev/mcp","version":"0.1.1","mcpName":"io.github.abm-dev-git/abm-mcp","description":"abm.dev — the account-based marketing API for AI agents. Search, Enrich, and Create across B2B people and companies; every field cited with a source and confidence score. Thin local stdio bridge to the hosted MCP server (mcp.abm.dev, OAuth 2.1 PKCE).","type":"module","bin":{"abm-mcp":"bin/abm-mcp.mjs"},"engines":{"node":">=18"},"dependencies":{"mcp-remote":"0.1.38"},"keywords":["mcp","enrichment","abm","b2b-data","ai-agents"],"repository":{"type":"git","url":"git+https://github.com/abm-dev-git/abm-mcp.git"},"homepage":"https://abm.dev","bugs":{"url":"https://abm.dev"},"author":{"name":"Foxley Farm Operations Ltd","url":"abm.dev"},"license":"MIT","publishConfig":{"access":"public"},"_id":"@abmdev/mcp@0.1.1","gitHead":"e336d9271f72cd8cd8172412bad8b155e3934e67","_nodeVersion":"22.21.0","_npmVersion":"10.9.4","dist":{"integrity":"sha512-D7/7fJ1YcZSflw4urMXoiH6zY00wW/MXQx4/HYab720RhH6K2Vyba7vXW7pUvsxVfqfy4qdjCIuWL/KeiDzzag==","shasum":"72ab605876c97286c4ad554396b86687a1633e30","tarball":"https://registry.npmjs.org/@abmdev/mcp/-/mcp-0.1.1.tgz","fileCount":5,"unpackedSize":11636,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIHi/OYTO7MR9R9ErRedtlmHOU7tWObLCyFZJ6mKxYMILAiEAowCHyQoBWJfe8c+PzgOhqSdwbUc7N2PwwXaWBJ5dQ6c="}]},"_npmUser":{"name":"smcleodau","email":"stuart@heyarchie.ai"},"directories":{},"maintainers":[{"name":"smcleodau","email":"stuart@heyarchie.ai"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp_0.1.1_1783684986212_0.07342334530246797"},"_hasShrinkwrap":false}},"time":{"created":"2026-06-09T15:39:38.982Z","modified":"2026-07-10T12:03:06.475Z","0.1.0":"2026-06-09T15:39:39.281Z","0.1.1":"2026-07-10T12:03:06.355Z"},"bugs":{"url":"https://abm.dev"},"author":{"name":"Foxley Farm Operations Ltd","url":"abm.dev"},"license":"MIT","homepage":"https://abm.dev","keywords":["mcp","enrichment","abm","b2b-data","ai-agents"],"repository":{"type":"git","url":"git+https://github.com/abm-dev-git/abm-mcp.git"},"description":"abm.dev — the account-based marketing API for AI agents. Search, Enrich, and Create across B2B people and companies; every field cited with a source and confidence score. Thin local stdio bridge to the hosted MCP server (mcp.abm.dev, OAuth 2.1 PKCE).","maintainers":[{"name":"smcleodau","email":"stuart@heyarchie.ai"}],"readme":"<p align=\"center\">\n  <img src=\"https://raw.githubusercontent.com/abm-dev-git/abm-mcp/main/assets/abm-diamond.svg\" alt=\"abm.dev\" width=\"96\" />\n</p>\n\n<h1 align=\"center\">abm.dev MCP server</h1>\n\n<p align=\"center\">\n  <strong>The account-based marketing API for AI agents.</strong><br/>\n  Search, Enrich, and Create across B2B people and companies — every field cited with a source and confidence score. One key, ten sources, no per-field bills.\n</p>\n\n<p align=\"center\">\n  <a href=\"https://www.npmjs.com/package/@abmdev/mcp\"><img src=\"https://img.shields.io/npm/v/@abmdev/mcp?color=2563eb&label=%40abmdev%2Fmcp\" alt=\"npm\" /></a>\n  <a href=\"https://github.com/abm-dev-git/abm-mcp/blob/main/LICENSE\"><img src=\"https://img.shields.io/badge/license-MIT-green\" alt=\"MIT\" /></a>\n  <a href=\"https://mcp.abm.dev/mcp\"><img src=\"https://img.shields.io/badge/MCP-streamable--http-7c3aed\" alt=\"MCP\" /></a>\n  <a href=\"https://smithery.ai/servers/abm-dev/gtm\"><img src=\"https://smithery.ai/badge/abm-dev/gtm\" alt=\"Smithery\" /></a>\n</p>\n\n- **Hosted server:** `https://mcp.abm.dev/mcp`\n- **Homepage:** https://abm.dev\n- **For agents (machine-readable):** https://abm.dev/llms.txt\n\n---\n\n## What your agents can do\n\nabm.dev is the account-based marketing API for AI agents. One key, one schema, four verbs:\n\n- **Search** — find companies and people by criteria. `search_companies`, `search_contacts`.\n- **Source** — hand it a target account, get the right buying-committee people back. Async briefs: `source`, `get_source`.\n- **Enrich** — cited, multi-source fields on any person or company. `create_enrichment`, `get_enrichment_fields`, `get_enrichment_sources`.\n- **Create** — write CRM records and stage outreach. `create_company`, `create_contact`, `create_outreach`; `queue_linkedin_post` **stages** a post for human approval — it never auto-publishes.\n\nEvery value carries its `source` and a `confidence` score (0–1). A value is cited or it is not returned. No fabricated facts.\n\n## What you get\n\n- **Eighty-nine canonical fields** per record — forty-three on the person, forty-six on the company.\n- **Forty signals** on every prospect.\n- **Ten sources**, resolved into one response — LinkedIn, Companies House, Perplexity, Tavily, Hunter, and others.\n- **A citation on every value** — `source` and `confidence` (0–1), with the winning source that produced it.\n\nNo per-source bills. No per-field charges. No silent fallbacks.\n\n---\n\n## Connect\n\n### Claude (custom connector)\n\n1. Open **Settings → Connectors → Custom**.\n2. Paste the server URL: `https://mcp.abm.dev/mcp`\n3. Complete the one-time sign-in when prompted.\n\nThen ask, in plain language: *\"Find the VP of Marketing at Acme, then enrich them.\"*\n\n### Cursor / Claude Code / Windsurf\n\nThese agents drive the REST API directly. Paste this prompt:\n\n> Read https://abm.dev/llms.txt. Request an API key, save it to `.env` as `ABM_API_KEY`, then run a test enrichment against `https://api.abm.dev/v1/enrichments`. Report the result with its citations.\n\n### Script and terminal agents\n\nCall the REST API directly:\n\n```bash\ncurl https://api.abm.dev/v1/enrichments \\\n  -H \"x-api-key: $ABM_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"type\":\"person\",\"input\":{\"email\":\"jane@acme.com\"}}'\n```\n\n`input` also accepts a LinkedIn URL or a company `domain`.\n\n---\n\n## Install (npx)\n\nPrefer a local command over a remote URL? The `@abmdev/mcp` package is a thin\nbridge: `npx -y @abmdev/mcp` launches a local STDIO MCP server that proxies to the\nhosted server at `https://mcp.abm.dev/mcp`, handling the OAuth 2.1 PKCE sign-in\nand token caching for you. It defines no tools of its own — it exposes whatever\nthe hosted server serves.\n\nAdd it to any MCP client that supports `command`/`args` (Claude Desktop,\nCursor, Windsurf, Claude Code, and others):\n\n```json\n{\n  \"mcpServers\": {\n    \"abm\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@abmdev/mcp\"]\n    }\n  }\n}\n```\n\nGeneric config snippet (for clients that take a bare command):\n\n```json\n{ \"command\": \"npx\", \"args\": [\"-y\", \"@abmdev/mcp\"] }\n```\n\nOn first run a browser window opens for the one-time sign-in; the token is then\ncached for subsequent runs. Point the bridge at a different endpoint by setting\nthe `ABM_MCP_URL` environment variable.\n\n> Either path reaches the same hosted server. Use the **custom connector**\n> (remote URL) above if your client supports it directly; use **npx** for\n> clients that only speak local `command`/`args`.\n\n---\n\n## Tools\n\nGrouped by verb — every field comes back with its `source` and `confidence` (0–1). Real-time SSE streaming for agent loops; webhooks fire when batch jobs finish.\n\n**Search** — `search_companies`, `search_contacts`: find accounts and people by criteria.\n\n**Source** — `source`, `get_source`: give it an account, get the right people back (async brief).\n\n**Enrich** — `create_enrichment`, `get_enrichment`, `get_enrichment_fields`, `get_enrichment_sources`: cited, multi-source fields on a person (from an email or LinkedIn URL) or a company (from a domain).\n\n**Create** — `create_company`, `create_contact`, `create_outreach`, `queue_linkedin_post`: write CRM records and **stage** outreach. Staged posts wait for human approval; nothing publishes automatically.\n\n---\n\n## Pricing\n\nPer-enrichment. No subscription. Credits never expire. All ten sources included — no add-ons.\n\nFrom about `€0.29` per enrichment. Packs: `30` credits `€2.89`, `100` `€9.29`, `500` `€36.99` (best value), `2,000` `€119.99`. The playground is free. Free launch credits with code `LAUNCHCODES`.\n\nSee https://abm.dev/#pricing.\n\n---\n\n## Links\n\n- **Homepage:** https://abm.dev\n- **For agents (llms.txt):** https://abm.dev/llms.txt\n- **Docs:** https://abm.dev/docs · [Getting started](https://abm.dev/docs/getting-started)\n- **API reference:** https://abm.dev/api-reference · [Enrichment](https://abm.dev/api-reference/enrichment) · [Jobs](https://abm.dev/api-reference/jobs)\n- **For developers:** https://abm.dev/for-developers · **For agents:** https://abm.dev/for-agents · **For marketers:** https://abm.dev/for-marketers\n- **Integrations:** [Claude connector](https://abm.dev/docs/integrations/claude-connector) · [HubSpot](https://abm.dev/docs/integrations/hubspot) · [Notion](https://abm.dev/docs/integrations/notion) · [Slack](https://abm.dev/docs/integrations/slack)\n- **Concepts:** [Enrichment](https://abm.dev/docs/concepts/enrichment) · [Confidence scores](https://abm.dev/docs/concepts/confidence-scores) · [Data sources](https://abm.dev/docs/concepts/data-sources) · [Canonical fields](https://abm.dev/docs/concepts/canonical-fields)\n- **Sign up:** https://abm.dev/sign-up · **Free playground:** https://abm.dev/dashboard/playground\n\n---\n\n## Registry reference\n\nThis repo is the public description of a hosted MCP server. The server runs at `https://mcp.abm.dev/mcp`; this repo is not its source. See [`server.json`](./server.json) for the machine-readable manifest.\n\n## Support\n\nQuestions or a stuck enrichment? Open a ticket: https://abm.dev\n\n## Operator\n\nFoxley Farm Operations Ltd · UK Company No. `16392009` · Oakham, United Kingdom. GDPR-compliant.\n","readmeFilename":"README.md"}