abm-mcp 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Foxley Farm Operations Ltd (abm.dev)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,153 @@
+<p align="center">
+  <img src="https://raw.githubusercontent.com/abm-dev-git/abm-mcp/main/assets/abm-diamond.svg" alt="abm.dev" width="96" />
+</p>
+
+<h1 align="center">abm.dev MCP server</h1>
+
+<p align="center">
+  <strong>Account-based marketing enrichment for AI agents.</strong><br/>
+  One endpoint. Cited, multi-source fields. Every value attributed.
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/abm-mcp"><img src="https://img.shields.io/npm/v/abm-mcp?color=2563eb&label=abm-mcp" alt="npm" /></a>
+  <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>
+  <a href="https://mcp.abm.dev/mcp"><img src="https://img.shields.io/badge/MCP-streamable--http-7c3aed" alt="MCP" /></a>
+  <a href="https://smithery.ai/servers/abm-dev/gtm"><img src="https://smithery.ai/badge/abm-dev/gtm" alt="Smithery" /></a>
+</p>
+
+- **Hosted server:** `https://mcp.abm.dev/mcp`
+- **Homepage:** https://abm.dev
+- **For agents (machine-readable):** https://abm.dev/llms.txt
+
+---
+
+## What abm.dev is
+
+Account-based marketing for AI agents. Give it an email, a LinkedIn URL, or a company domain; get back a structured record on the person and the company they work for. Every value carries its source, a confidence score, and a last-verified timestamp. A value is cited or it is not returned. No fabricated facts.
+
+## What you get
+
+- **Eighty-nine canonical fields** per record — forty-three on the person, forty-six on the company.
+- **Forty signals** on every prospect.
+- **Ten sources**, resolved into one response — LinkedIn, Companies House, Perplexity, Tavily, Hunter, and others.
+- **Citations on every value** — `source`, `confidence` (0–1), and `freshness` (last-verified timestamp).
+
+No per-source bills. No per-field charges. No silent fallbacks.
+
+---
+
+## Connect
+
+### Claude (custom connector)
+
+1. Open **Settings → Connectors → Custom**.
+2. Paste the server URL: `https://mcp.abm.dev/mcp`
+3. Complete the one-time sign-in when prompted.
+
+Then ask, in plain language: *"Enrich jane@acme.com."*
+
+### Cursor / Claude Code / Windsurf
+
+These agents drive the REST API directly. Paste this prompt:
+
+> 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.
+
+### Script and terminal agents
+
+Call the REST API directly:
+
+```bash
+curl https://api.abm.dev/v1/enrichments \
+  -H "x-api-key: $ABM_API_KEY" \
+  -H "Content-Type: application/json" \
+  -d '{"type":"person","input":{"email":"jane@acme.com"}}'
+```
+
+`input` also accepts a LinkedIn URL or a company `domain`.
+
+---
+
+## Install (npx)
+
+Prefer a local command over a remote URL? The `abm-mcp` package is a thin
+bridge: `npx -y abm-mcp` launches a local STDIO MCP server that proxies to the
+hosted server at `https://mcp.abm.dev/mcp`, handling the OAuth 2.1 PKCE sign-in
+and token caching for you. It defines no tools of its own — it exposes whatever
+the hosted server serves.
+
+Add it to any MCP client that supports `command`/`args` (Claude Desktop,
+Cursor, Windsurf, Claude Code, and others):
+
+```json
+{
+  "mcpServers": {
+    "abm": {
+      "command": "npx",
+      "args": ["-y", "abm-mcp"]
+    }
+  }
+}
+```
+
+Generic config snippet (for clients that take a bare command):
+
+```json
+{ "command": "npx", "args": ["-y", "abm-mcp"] }
+```
+
+On first run a browser window opens for the one-time sign-in; the token is then
+cached for subsequent runs. Point the bridge at a different endpoint by setting
+the `ABM_MCP_URL` environment variable.
+
+> Either path reaches the same hosted server. Use the **custom connector**
+> (remote URL) above if your client supports it directly; use **npx** for
+> clients that only speak local `command`/`args`.
+
+---
+
+## Tools
+
+The server exposes **enrichment**:
+
+- **Enrich a person** — from an email or a LinkedIn URL. Returns the forty-three person fields plus the company they work for.
+- **Enrich a company** — from a domain. Returns the forty-six company fields.
+
+Every field comes back with its `source`, `confidence`, and `freshness`. Real-time SSE streaming for agent loops; webhooks fire when batch jobs finish.
+
+---
+
+## Pricing
+
+Per-enrichment. No subscription. Credits never expire. All ten sources included — no add-ons.
+
+From 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`.
+
+See https://abm.dev/#pricing.
+
+---
+
+## Links
+
+- **Homepage:** https://abm.dev
+- **For agents (llms.txt):** https://abm.dev/llms.txt
+- **Docs:** https://abm.dev/docs · [Getting started](https://abm.dev/docs/getting-started)
+- **API reference:** https://abm.dev/api-reference · [Enrichment](https://abm.dev/api-reference/enrichment) · [Jobs](https://abm.dev/api-reference/jobs)
+- **For developers:** https://abm.dev/for-developers · **For agents:** https://abm.dev/for-agents · **For marketers:** https://abm.dev/for-marketers
+- **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)
+- **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)
+- **Sign up:** https://abm.dev/sign-up · **Free playground:** https://abm.dev/dashboard/playground
+
+---
+
+## Registry reference
+
+This 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.
+
+## Support
+
+Questions or a stuck enrichment? Open a ticket: https://abm.dev
+
+## Operator
+
+Foxley Farm Operations Ltd · UK Company No. `16392009` · Oakham, United Kingdom. GDPR-compliant.

package/bin/abm-mcp.mjs

@@ -0,0 +1,43 @@
+#!/usr/bin/env node
+// abm-mcp — thin local STDIO bridge to the hosted abm.dev MCP server.
+//
+// Launches the community `mcp-remote` proxy pointed at abm.dev's hosted MCP
+// endpoint. It does NOT define any tools, fields, or schemas: whatever the
+// remote serves is exactly what this exposes. Shipping a new server-side
+// version needs zero change here.
+//
+// Endpoint: defaults to https://mcp.abm.dev/mcp, overridable via ABM_MCP_URL.
+
+import { spawn } from "node:child_process";
+import { createRequire } from "node:module";
+
+const ENDPOINT = process.env.ABM_MCP_URL || "https://mcp.abm.dev/mcp";
+
+// Resolve the bundled mcp-remote proxy entry from its own package manifest,
+// so we run exactly the version pinned in our dependencies.
+const require = createRequire(import.meta.url);
+const proxyEntry = require.resolve("mcp-remote/dist/proxy.js");
+
+// Forward the endpoint plus any extra CLI args the caller passed through.
+const passthrough = process.argv.slice(2);
+const args = [proxyEntry, ENDPOINT, ...passthrough];
+
+const child = spawn(process.execPath, args, { stdio: "inherit" });
+
+// Relay termination signals so the bridge shuts down cleanly with its parent.
+for (const signal of ["SIGINT", "SIGTERM", "SIGHUP"]) {
+  process.on(signal, () => child.kill(signal));
+}
+
+child.on("error", (err) => {
+  process.stderr.write(`abm-mcp: failed to start bridge: ${err.message}\n`);
+  process.exit(1);
+});
+
+child.on("exit", (code, signal) => {
+  if (signal) {
+    process.kill(process.pid, signal);
+    return;
+  }
+  process.exit(code ?? 0);
+});

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "abm-mcp",
+  "version": "0.1.0",
+  "mcpName": "io.github.abm-dev-git/abm-mcp",
+  "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.",
+  "type": "module",
+  "bin": {
+    "abm-mcp": "bin/abm-mcp.mjs"
+  },
+  "files": [
+    "bin",
+    "README.md",
+    "server.json",
+    "LICENSE"
+  ],
+  "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": "Foxley Farm Operations Ltd (abm.dev)",
+  "license": "MIT"
+}

package/server.json

@@ -0,0 +1,17 @@
+{
+  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-09-29/server.schema.json",
+  "name": "io.github.abm-dev-git/abm-mcp",
+  "description": "Account-based marketing for AI agents. A great rep once knew every account. Now your agents do.",
+  "version": "1.0.0",
+  "websiteUrl": "https://abm.dev",
+  "repository": {
+    "url": "https://github.com/abm-dev-git/abm-mcp",
+    "source": "github"
+  },
+  "remotes": [
+    {
+      "type": "streamable-http",
+      "url": "https://mcp.abm.dev/mcp"
+    }
+  ]
+}