{
  "markdown": "# BizVerify MCP Server\n\n> KYB for AI agents — verify and search business entities across US state and international company registries, straight from any MCP client.\n\n[![Glama score](https://glama.ai/mcp/servers/BizVerify/bizverify-mcp/badges/score.svg)](https://glama.ai/mcp/servers/BizVerify/bizverify-mcp)\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](./LICENSE)\n\n[BizVerify](https://bizverify.co) confirms a company's legal existence, status, good standing, registered agent, officers, and filing history by reading official government business registries in real time.\n\nThe canonical BizVerify MCP server is **hosted** as a Streamable HTTP endpoint:\n\n```\nhttps://api.bizverify.co/mcp\n```\n\nThis repository packages that server as a local **stdio bridge** (plus a Docker image) for MCP clients and sandboxes that expect a local process. The bridge is a thin transparent proxy — tool definitions and results come directly from the hosted server, so it never drifts out of sync.\n\n## Tools\n\n| Tool | Auth | What it does |\n|------|------|--------------|\n| `get_config` | – | Supported jurisdictions, credit pricing, packages, features |\n| `list_jurisdictions` | – | All jurisdictions with capabilities and active status |\n| `verify_business` | ✅ | Confirm a named business in one jurisdiction — existence, status, good standing (quick), plus entity type, formation date, registered agent, officers, principal address and filings (deep) |\n| `search_entities` | ✅ | Discover candidate businesses by name across one or all active jurisdictions |\n| `check_job_status` | ✅ | Poll an async verification job (free) |\n| `get_entity` | ✅ | Retrieve cached entity data by ID (free) |\n| `get_entity_history` | ✅ | Historical verification snapshots for an entity |\n| `get_account` | ✅ | Account details and credit balance |\n| `purchase_credits` | ✅ | Create a Stripe checkout session for more credits |\n\nTools marked ✅ require an API key (or OAuth token). `get_config` and `list_jurisdictions` are free and unauthenticated.\n\n## Quick start\n\n### Option A — Hosted endpoint (recommended)\n\nIf your client supports remote MCP servers, just point it at `https://api.bizverify.co/mcp` and send your key as an `X-API-Key` header (OAuth 2.1 Bearer tokens are also accepted).\n\nFor stdio-only clients, bridge the hosted endpoint with [`mcp-remote`](https://www.npmjs.com/package/mcp-remote):\n\n```json\n{\n  \"mcpServers\": {\n    \"bizverify\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"-y\", \"mcp-remote\", \"https://api.bizverify.co/mcp\",\n        \"--header\", \"X-API-Key:${BIZVERIFY_API_KEY}\"\n      ],\n      \"env\": { \"BIZVERIFY_API_KEY\": \"your-api-key\" }\n    }\n  }\n}\n```\n\n### Option B — This bridge (from source)\n\n```bash\ngit clone https://github.com/BizVerify/bizverify-mcp.git\ncd bizverify-mcp\nnpm install\nnpm run build\n```\n\nThen register it with your client (Claude Desktop, Cursor, etc.):\n\n```json\n{\n  \"mcpServers\": {\n    \"bizverify\": {\n      \"command\": \"node\",\n      \"args\": [\"/absolute/path/to/bizverify-mcp/dist/index.js\"],\n      \"env\": { \"BIZVERIFY_API_KEY\": \"your-api-key\" }\n    }\n  }\n}\n```\n\n### Option C — Docker\n\n```bash\ndocker build -t bizverify-mcp .\ndocker run -i --rm -e BIZVERIFY_API_KEY=your-api-key bizverify-mcp\n```\n\n```json\n{\n  \"mcpServers\": {\n    \"bizverify\": {\n      \"command\": \"docker\",\n      \"args\": [\"run\", \"-i\", \"--rm\", \"-e\", \"BIZVERIFY_API_KEY\", \"bizverify-mcp\"],\n      \"env\": { \"BIZVERIFY_API_KEY\": \"your-api-key\" }\n    }\n  }\n}\n```\n\n## Configuration\n\n| Env var | Required | Default | Description |\n|---------|----------|---------|-------------|\n| `BIZVERIFY_API_KEY` | For authenticated tools | – | Your BizVerify API key, sent as `X-API-Key`. `get_config` and `list_jurisdictions` work without it. |\n| `BIZVERIFY_MCP_URL` | No | `https://api.bizverify.co/mcp` | Override the upstream MCP endpoint. |\n\n## Getting an API key\n\nCreate one in seconds — new accounts get **50 free credits**:\n\n```bash\n# 1. Request an access code (sent by email)\ncurl -X POST https://api.bizverify.co/v1/auth/request-access \\\n  -H 'Content-Type: application/json' \\\n  -d '{\"email\":\"you@example.com\",\"accept_terms\":true}'\n\n# 2. Exchange the 6-digit code for an API key\ncurl -X POST https://api.bizverify.co/v1/auth/verify-access \\\n  -H 'Content-Type: application/json' \\\n  -d '{\"email\":\"you@example.com\",\"code\":\"123456\",\"label\":\"mcp\"}'\n```\n\nSee the [setup guide](https://bizverify.co/mcp/) and [docs](https://docs.bizverify.co) for full details.\n\n## Development\n\n```bash\nnpm install\nnpm run build        # compile to dist/\nnpm run typecheck    # type-check only\nnpm start            # run the stdio bridge\n\n# Refresh the offline tool snapshot from the live endpoint\nnode scripts/gen-snapshot.mjs\n```\n\nThe bundled `src/tools-snapshot.ts` is used **only** as an offline fallback for `tools/list` (e.g. during a sandboxed container check). Live calls always proxy to the hosted server.\n\n## Links\n\n- 🌐 Website: https://bizverify.co\n- 🔌 MCP setup guide: https://bizverify.co/mcp/\n- 📚 Docs: https://docs.bizverify.co\n- 🧩 Glama connector: https://glama.ai/mcp/connectors/co.bizverify/mcp\n\n## License\n\n[MIT](./LICENSE) © BizVerify\n",
  "bytes": 5131,
  "sha": "5d1d7e37901288c57610bcbdbc711bd995489e6eee2de3f8d246cf8f08259e25",
  "repo_slug": "bizverify/bizverify-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_co_bizverify_mcp_b1d942a4/readme"
}