@buyboxclub/mcp

A Model Context Protocol server for the Buy Box Club property underwriting API.

Score 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.

What it does

Exposes two tools to Claude:

| Tool | Cost | Use when | |---|---|---| | clubMatchScore | 1 credit per call (3,000/mo cap) | User gives just an address | | userMatchScore | Free, unlimited | User provides purchase price, rent, taxes, etc. |

When supported by your account templates, both responses include a signed pdf_url to the full Investment Summary PDF.

Claude renders the result as a markdown table:

| Field              | Value                            |
|--------------------|----------------------------------|
| Property           | 1141 Madeira St, Indianapolis IN |
| Best Strategy      | Seller Finance                   |
| Match Score        | 81                               |
| Monthly Cash Flow  | $312.45                          |
| CoC ROI            | 8.52%                            |
| DSCR               | 1.25                             |
| Recommendation     | Strong match — pursue            |

Setup — Claude Desktop

1. Get your Buy Box Club API key from buyboxclub.io/integrations.

2. Open Claude Desktop → Settings → Developer → Edit Config (or edit ~/Library/Application Support/Claude/claude_desktop_config.json directly on macOS).

3. Add:

   {
     "mcpServers": {
       "buyboxclub": {
         "command": "npx",
         "args": ["-y", "@buyboxclub/mcp"],
         "env": {
           "BUYBOXCLUB_API_KEY": "bbc_your_key_here"
         }
       }
     }
   }

4. Restart Claude Desktop.

5. Ask: "Underwrite 1141 Madeira St, Indianapolis, IN 46203."

Setup — Claude Code CLI

Run this in your terminal (replace the placeholder with your real key):

claude mcp add buyboxclub \
  --scope user \
  --env BUYBOXCLUB_API_KEY=bbc_your_key_here \
  -- npx -y @buyboxclub/mcp

Verify with claude mcp list — you should see buyboxclub listed.

Prefer 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.

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).

Start 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.

Setup — Codex CLI

OpenAI Codex CLI also speaks MCP — same @buyboxclub/mcp package, just a different config file (TOML, not JSON).

codex mcp add buyboxclub \
  --env BUYBOXCLUB_API_KEY=bbc_your_key_here \
  -- npx -y @buyboxclub/mcp

Or edit ~/.codex/config.toml directly:

[mcp_servers.buyboxclub]
command = "npx"
args = ["-y", "@buyboxclub/mcp"]
env = { BUYBOXCLUB_API_KEY = "bbc_your_key_here" }

Start a new Codex session — MCP servers only load at session start. Codex MCP docs: https://developers.openai.com/codex/mcp.

Requirements

• An active Buy Box Club subscription — either API Access Only or Match Pro
• A valid API key generated from buyboxclub.io/integrations
• Node 18+ (Claude Desktop users already have this via the bundled runtime)

Support

• API documentation (interactive): buyboxclub.io/api-docs
• API documentation (plain markdown, agent-friendly): buyboxclub.io/api-docs.md
• Account, billing, key management: buyboxclub.io/integrations

License

MIT — see LICENSE.