Marketproof MCP connects Claude Code to live NYC real-estate data: building and unit search, recorded sales and comps, owner and contact lookups, DOB permits and violations, and market analysis. You can pull live data and run multi-step research from your terminal, and write the results straight into your project.
Before you start
A Marketproof MCP account with a credit balance. Sign up at mcp.marketproof.com and buy a credit pack. You need credits to run any queries.
Claude Code installed and signed in. (Install with
npm install -g @anthropic-ai/claude-code, then runclaude. See code.claude.com for the latest install steps.)A Connection from your Marketproof console, which gives you three values: a Server URL, a Client ID, and a Client Secret. Create one under Connect your AI agent.
Connect it
Get your credentials. In the Marketproof console, open Connect your AI agent, create a connection (or open an existing one), and copy the Server URL (
https://mcp.marketproof.com/tools), Client ID, and Client Secret. The secret is shown only once at creation, so copy it now.Add the server to Claude Code. In your terminal, run:
claude mcp add --transport http --scope user \ --client-id YOUR_CLIENT_ID --client-secret \ marketproof https://mcp.marketproof.com/tools
The
--client-secretflag prompts you to paste the secret (the input stays hidden).--scope usermakes Marketproof available in every Claude Code session. Use--scope projectinstead to share it with a repo through a checked-in.mcp.json.
Prefer not to create a Connection first? Claude Code can register itself automatically. Omit the credential flags and runclaude mcp add --transport http --scope user marketproof https://mcp.marketproof.com/tools.Authenticate. Start Claude Code (
claude) and run the/mcpcommand. Find marketproof in the list and choose Authenticate. Your browser opens the Marketproof sign-in and authorization screen. Log in and click Authorize. (From the shell you can also runclaude mcp login marketproof.)Confirm it is connected. Back in Claude Code,
/mcpnow shows marketproof as connected, with its capabilities available. You can also runclaude mcp listorclaude mcp get marketproofin the terminal.
What you can do now
Ask Claude Code anything that needs NYC real-estate data. A few to try:
"Find five recent comparable sales for The Solaire, 20 River Terrace, and summarize the price range."
"Pull the open DOB violations and recent permits for 250 East 40th Street."
"Show this week's Manhattan contract activity broken down by property type, with days on market."
Claude Code pulls the data, chains the results, and can write the output to files in your project.
Troubleshooting
marketproof shows "failed" or "needs authentication." Run
/mcpand choose Authenticate (orclaude mcp login marketprooffrom the shell) to complete the OAuth flow.The browser did not open, or the redirect failed. Copy the authorization URL Claude Code prints and open it manually. If the redirect back fails, paste the full callback URL from your browser into the prompt. Over SSH, use
claude mcp login --no-browser marketproof.Every request fails with "insufficient credits." Your Marketproof balance is empty. Buy a credit pack in the console, then retry.
"Incompatible auth" or a transport error. Confirm you used
--transport httpand the URLhttps://mcp.marketproof.com/tools(not an/ssepath). Remove and re-add if needed withclaude mcp remove marketproof.Lost or wrong Client Secret. The secret is shown only once. Rotate it in the console (open the Connection → Rotate), then re-run the
claude mcp addcommand with the new value.