{"_id":"@buyboxclub/mcp","_rev":"5-1bc80aff1f1f2bf8fc964cd6c5d0e306","name":"@buyboxclub/mcp","dist-tags":{"latest":"0.2.3"},"versions":{"0.1.0":{"name":"@buyboxclub/mcp","version":"0.1.0","keywords":["mcp","model-context-protocol","buy-box-club","real-estate","underwriting","claude","claude-desktop"],"license":"MIT","_id":"@buyboxclub/mcp@0.1.0","maintainers":[{"name":"munsanco","email":"munsanco@gmail.com"}],"homepage":"https://github.com/munsanco13/buyboxclub-v2#readme","bugs":{"url":"https://github.com/munsanco13/buyboxclub-v2/issues"},"bin":{"buyboxclub-mcp":"dist/index.js"},"dist":{"shasum":"ea76f364761914eca86ae527e587a1abf3ec1d3a","tarball":"https://registry.npmjs.org/@buyboxclub/mcp/-/mcp-0.1.0.tgz","fileCount":5,"integrity":"sha512-bC5gZGAPZSOb5OHS37KJjGKHP97fQopnSHNsKbFp5MxQA1Nfp4ELNVTp3R0YwWRAaMGcmHJs3V+SYbpfqFf5Bg==","signatures":[{"sig":"MEQCIA2GbtwgdM+1rKvEdg2Bz8Fw3r0V2yiijaz1eDi0w1nZAiBW8HMuD0d0tdkRUByLfh8zFwMIVYpWoFtuh+8ArFQYcQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":28448},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18"},"scripts":{"dev":"tsc --watch","test":"node --test dist/*.test.js","build":"tsc","start":"node dist/index.js","prepublishOnly":"npm run build"},"_npmUser":{"name":"munsanco","email":"munsanco@gmail.com"},"repository":{"url":"git+https://github.com/munsanco13/buyboxclub-v2.git","type":"git","directory":"mcp-server"},"_npmVersion":"10.9.2","description":"Model Context Protocol server for the Buy Box Club property underwriting API. Lets Claude Desktop (and any MCP-compatible client) score properties natively with a single tool call.","directories":{},"_nodeVersion":"23.7.0","dependencies":{"zod":"^3.23.8","@modelcontextprotocol/sdk":"^1.0.4"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.7.2","@types/node":"^22.10.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp_0.1.0_1776981398047_0.4060085367969106","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"@buyboxclub/mcp","version":"0.2.0","keywords":["mcp","model-context-protocol","buy-box-club","real-estate","underwriting","claude","claude-desktop"],"license":"MIT","_id":"@buyboxclub/mcp@0.2.0","maintainers":[{"name":"munsanco","email":"munsanco@gmail.com"}],"homepage":"https://github.com/munsanco13/buyboxclub-v2#readme","bugs":{"url":"https://github.com/munsanco13/buyboxclub-v2/issues"},"bin":{"buyboxclub-mcp":"dist/index.js"},"dist":{"shasum":"60b557b1468a6eab0311c720f1d1122a24e64d63","tarball":"https://registry.npmjs.org/@buyboxclub/mcp/-/mcp-0.2.0.tgz","fileCount":11,"integrity":"sha512-lU/uLL1Q4pABTlMs0Mwbw7U4PNOSYHTBEzRfWdTqU4B7ip+OsZaXqmKitRb8a8JePE5S/wS105MMkFq6E6J2Ig==","signatures":[{"sig":"MEQCIEAoPyoewJ04O4oMg3MAhTXuTHR07SuZkV6lI2TZwmczAiBSriWHpLJ54ZKPnRt1AxPh8M9OSesqNTlccqCcP0CjIw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":58104},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18"},"scripts":{"dev":"tsc --watch","test":"node --test dist/*.test.js","build":"tsc","start":"node dist/index.js","prepublishOnly":"npm run build"},"_npmUser":{"name":"munsanco","email":"munsanco@gmail.com"},"repository":{"url":"git+https://github.com/munsanco13/buyboxclub-v2.git","type":"git","directory":"mcp-server"},"_npmVersion":"10.9.2","description":"Model Context Protocol server for the Buy Box Club property underwriting API. Lets Claude Desktop (and any MCP-compatible client) score properties natively with a single tool call.","directories":{},"_nodeVersion":"23.7.0","dependencies":{"zod":"^3.23.8","@modelcontextprotocol/sdk":"^1.0.4"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.7.2","@types/node":"^22.10.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp_0.2.0_1777399994849_0.3961589487846593","host":"s3://npm-registry-packages-npm-production"}},"0.2.1":{"name":"@buyboxclub/mcp","version":"0.2.1","keywords":["mcp","model-context-protocol","buy-box-club","real-estate","underwriting","claude","claude-desktop"],"license":"MIT","_id":"@buyboxclub/mcp@0.2.1","maintainers":[{"name":"munsanco","email":"munsanco@gmail.com"}],"homepage":"https://github.com/munsanco13/buyboxclub-v2#readme","bugs":{"url":"https://github.com/munsanco13/buyboxclub-v2/issues"},"bin":{"mcp":"dist/index.js","buyboxclub-mcp":"dist/index.js"},"dist":{"shasum":"f7b2a4f2d3fc3f95ad43797caffca6a0f4b039de","tarball":"https://registry.npmjs.org/@buyboxclub/mcp/-/mcp-0.2.1.tgz","fileCount":11,"integrity":"sha512-ckt68HruKCCWBOb42ifqu8oSCFh5sdS3m7Uxtcqa+jw8Rtiw0+iFzjzaZm/SWQynS5s3gqvlZw/mPAUvSoTRLA==","signatures":[{"sig":"MEUCIQC8G++zvo7kLEqh47Dmb38gWU4jBFEx4/i7bTnbrEyUbgIgCg04fSmA85Lq+UKK3YLTlmfKuxPRnpW9fo2tagRzDCc=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":58132},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18"},"scripts":{"dev":"tsc --watch","test":"node --test dist/*.test.js","build":"tsc","start":"node dist/index.js","prepublishOnly":"npm run build"},"_npmUser":{"name":"munsanco","email":"munsanco@gmail.com"},"repository":{"url":"git+https://github.com/munsanco13/buyboxclub-v2.git","type":"git","directory":"mcp-server"},"_npmVersion":"10.9.2","description":"Model Context Protocol server for the Buy Box Club property underwriting API. Lets Claude Desktop (and any MCP-compatible client) score properties natively with a single tool call.","directories":{},"_nodeVersion":"23.7.0","dependencies":{"zod":"^3.23.8","@modelcontextprotocol/sdk":"^1.0.4"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.7.2","@types/node":"^22.10.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp_0.2.1_1777400074710_0.5685099274750074","host":"s3://npm-registry-packages-npm-production"}},"0.2.2":{"name":"@buyboxclub/mcp","version":"0.2.2","keywords":["mcp","model-context-protocol","buy-box-club","real-estate","underwriting","claude","claude-desktop"],"license":"MIT","_id":"@buyboxclub/mcp@0.2.2","maintainers":[{"name":"munsanco","email":"munsanco@gmail.com"}],"homepage":"https://github.com/munsanco13/buyboxclub-v2#readme","bugs":{"url":"https://github.com/munsanco13/buyboxclub-v2/issues"},"bin":{"mcp":"dist/index.js","buyboxclub-mcp":"dist/index.js"},"dist":{"shasum":"e5058ba48c74b9118fc02c8c6e9286f720b585c3","tarball":"https://registry.npmjs.org/@buyboxclub/mcp/-/mcp-0.2.2.tgz","fileCount":11,"integrity":"sha512-gkidQU7mfwcJTL127yKodpe4zkyulDdUZ53OVESJ0fdFe/Lm6ohTLBz7vSucmtumE2VDoImXYMRx989w0/Rqkw==","signatures":[{"sig":"MEYCIQDc1dMDjtUU43ftbsOfFOYnvLzm8UM5vuROMpKuO/gEMgIhANd3aW7yJbzTd7fLsvrYq91/UY8dCkP272vZROr6etf0","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":58158},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18"},"scripts":{"dev":"tsc --watch","test":"node --test dist/*.test.js","build":"tsc","start":"node dist/index.js","prepublishOnly":"npm run build && chmod +x dist/index.js"},"_npmUser":{"name":"munsanco","email":"munsanco@gmail.com"},"repository":{"url":"git+https://github.com/munsanco13/buyboxclub-v2.git","type":"git","directory":"mcp-server"},"_npmVersion":"10.9.2","description":"Model Context Protocol server for the Buy Box Club property underwriting API. Lets Claude Desktop (and any MCP-compatible client) score properties natively with a single tool call.","directories":{},"_nodeVersion":"23.7.0","dependencies":{"zod":"^3.23.8","@modelcontextprotocol/sdk":"^1.0.4"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.7.2","@types/node":"^22.10.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp_0.2.2_1777400113715_0.4233280200229588","host":"s3://npm-registry-packages-npm-production"}},"0.2.3":{"name":"@buyboxclub/mcp","version":"0.2.3","description":"Model Context Protocol server for the Buy Box Club property underwriting API. Lets Claude Desktop (and any MCP-compatible client) score properties natively with a single tool call.","license":"MIT","type":"module","bin":{"mcp":"dist/index.js","buyboxclub-mcp":"dist/index.js"},"main":"dist/index.js","scripts":{"build":"tsc","dev":"tsc --watch","start":"node dist/index.js","prepublishOnly":"npm run build && chmod +x dist/index.js","test":"node --test dist/*.test.js"},"dependencies":{"@modelcontextprotocol/sdk":"^1.0.4","zod":"^3.23.8"},"devDependencies":{"@types/node":"^22.10.0","typescript":"^5.7.2"},"engines":{"node":">=18"},"publishConfig":{"access":"public"},"keywords":["mcp","model-context-protocol","buy-box-club","real-estate","underwriting","claude","claude-desktop"],"repository":{"type":"git","url":"git+https://github.com/munsanco13/buyboxclub-v2.git","directory":"mcp-server"},"_id":"@buyboxclub/mcp@0.2.3","types":"./dist/index.d.ts","bugs":{"url":"https://github.com/munsanco13/buyboxclub-v2/issues"},"homepage":"https://github.com/munsanco13/buyboxclub-v2#readme","_nodeVersion":"23.7.0","_npmVersion":"10.9.2","dist":{"integrity":"sha512-lcjIySG3ERvnkBgt/12NWzSL4daVQ+S1L6t3CkXSZ+cHoHTcuq/HWB4kDP4t9IZH4PrYylyCYe2VErTQxYwG/A==","shasum":"529f7995829aa06753676acea57b91ce9289c07a","tarball":"https://registry.npmjs.org/@buyboxclub/mcp/-/mcp-0.2.3.tgz","fileCount":11,"unpackedSize":59930,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQDp6T21eJ9z3862krpHxUZwAQ9+lafuUSyFoGbQbmYLuAIgEDyfB/hL6e20Xga/1ZKbAv4gjFGkgVuMYqMFqx4GOp8="}]},"_npmUser":{"name":"munsanco","email":"munsanco@gmail.com"},"directories":{},"maintainers":[{"name":"munsanco","email":"munsanco@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp_0.2.3_1778436433380_0.30827256243963075"},"_hasShrinkwrap":false}},"time":{"created":"2026-04-23T21:56:37.909Z","modified":"2026-05-10T18:07:13.686Z","0.1.0":"2026-04-23T21:56:38.201Z","0.2.0":"2026-04-28T18:13:15.044Z","0.2.1":"2026-04-28T18:14:34.839Z","0.2.2":"2026-04-28T18:15:13.902Z","0.2.3":"2026-05-10T18:07:13.531Z"},"bugs":{"url":"https://github.com/munsanco13/buyboxclub-v2/issues"},"license":"MIT","homepage":"https://github.com/munsanco13/buyboxclub-v2#readme","keywords":["mcp","model-context-protocol","buy-box-club","real-estate","underwriting","claude","claude-desktop"],"repository":{"type":"git","url":"git+https://github.com/munsanco13/buyboxclub-v2.git","directory":"mcp-server"},"description":"Model Context Protocol server for the Buy Box Club property underwriting API. Lets Claude Desktop (and any MCP-compatible client) score properties natively with a single tool call.","maintainers":[{"name":"munsanco","email":"munsanco@gmail.com"}],"readme":"# @buyboxclub/mcp\n\nA [Model Context Protocol](https://modelcontextprotocol.io) server for the [Buy Box Club](https://buyboxclub.io) property underwriting API.\n\nScore properties against your Buy Box Club criteria directly from Claude Desktop or any MCP-compatible client. One tool call, one API credit, a clean table summary in your chat.\n\n---\n\n## What it does\n\nExposes two tools to Claude:\n\n| Tool | Cost | Use when |\n|---|---|---|\n| `clubMatchScore` | 1 credit per call (3,000/mo cap) | User gives just an address |\n| `userMatchScore` | Free, unlimited | User provides purchase price, rent, taxes, etc. |\n\nWhen supported by your account templates, both responses include a signed `pdf_url` to the full Investment Summary PDF.\n\nClaude renders the result as a markdown table:\n\n```\n| Field              | Value                            |\n|--------------------|----------------------------------|\n| Property           | 1141 Madeira St, Indianapolis IN |\n| Best Strategy      | Seller Finance                   |\n| Match Score        | 81                               |\n| Monthly Cash Flow  | $312.45                          |\n| CoC ROI            | 8.52%                            |\n| DSCR               | 1.25                             |\n| Recommendation     | Strong match — pursue            |\n```\n\n---\n\n## Setup — Claude Desktop\n\n1. Get your Buy Box Club API key from [buyboxclub.io/integrations](https://buyboxclub.io/integrations).\n2. Open Claude Desktop → Settings → Developer → Edit Config (or edit `~/Library/Application Support/Claude/claude_desktop_config.json` directly on macOS).\n3. Add:\n\n   ```json\n   {\n     \"mcpServers\": {\n       \"buyboxclub\": {\n         \"command\": \"npx\",\n         \"args\": [\"-y\", \"@buyboxclub/mcp\"],\n         \"env\": {\n           \"BUYBOXCLUB_API_KEY\": \"bbc_your_key_here\"\n         }\n       }\n     }\n   }\n   ```\n\n4. Restart Claude Desktop.\n5. Ask: *\"Underwrite 1141 Madeira St, Indianapolis, IN 46203.\"*\n\n---\n\n## Setup — Claude Code CLI\n\nRun this in your terminal (replace the placeholder with your real key):\n\n```bash\nclaude mcp add buyboxclub \\\n  --scope user \\\n  --env BUYBOXCLUB_API_KEY=bbc_your_key_here \\\n  -- npx -y @buyboxclub/mcp\n```\n\nVerify with `claude mcp list` — you should see `buyboxclub` listed.\n\nPrefer editing config directly? Drop the JSON block from the Claude Desktop section above into a project-level `.mcp.json` (checked into your repo, shared with teammates) instead.\n\n> **Note:** MCP servers go in `.mcp.json` or `~/.claude.json` — **not** `~/.claude/settings.json` (that file is for permissions/hooks/env, and `mcpServers` there is silently ignored).\n\nStart a *new* Claude Code session (`claude` in a fresh terminal — MCP servers only load at session start). The `clubMatchScore` and `userMatchScore` tools become available automatically.\n\n---\n\n## Setup — Codex CLI\n\nOpenAI Codex CLI also speaks MCP — same `@buyboxclub/mcp` package, just a different config file (TOML, not JSON).\n\n```bash\ncodex mcp add buyboxclub \\\n  --env BUYBOXCLUB_API_KEY=bbc_your_key_here \\\n  -- npx -y @buyboxclub/mcp\n```\n\nOr edit `~/.codex/config.toml` directly:\n\n```toml\n[mcp_servers.buyboxclub]\ncommand = \"npx\"\nargs = [\"-y\", \"@buyboxclub/mcp\"]\nenv = { BUYBOXCLUB_API_KEY = \"bbc_your_key_here\" }\n```\n\nStart a *new* Codex session — MCP servers only load at session start. Codex MCP docs: <https://developers.openai.com/codex/mcp>.\n\n---\n\n## Requirements\n\n- An active Buy Box Club subscription — either **API Access Only** or **Match Pro**\n- A valid API key generated from [buyboxclub.io/integrations](https://buyboxclub.io/integrations)\n- Node 18+ (Claude Desktop users already have this via the bundled runtime)\n\n---\n\n## Support\n\n- API documentation (interactive): [buyboxclub.io/api-docs](https://buyboxclub.io/api-docs)\n- API documentation (plain markdown, agent-friendly): [buyboxclub.io/api-docs.md](https://buyboxclub.io/api-docs.md)\n- Account, billing, key management: [buyboxclub.io/integrations](https://buyboxclub.io/integrations)\n\n---\n\n## License\n\nMIT — see [LICENSE](./LICENSE).\n","readmeFilename":"README.md"}