API › Setup guides › VS Code

VS CodeWorks today

VS Code agent mode reads MCP servers from mcp.json and supports custom headers.

You need a key first. API keys come with the Professional plan. Generate one on your account page, under API access. It starts with jbp_ and is shown once, so copy it when it appears. Everywhere below, replace jbp_your_key with it.

Set it up

  1. Create .vscode/mcp.json in your workspace, or open the user-level config from the command palette with MCP: Open User Configuration.
  2. Add the server.
    {
      "servers": {
        "jbparcel": {
          "type": "http",
          "url": "https://jbparcel.com/mcp",
          "headers": {
            "Authorization": "Bearer jbp_your_key"
          }
        }
      }
    }
  3. Reload the window, open Chat in agent mode, and check the tools picker for the three JB PARCEL tools.
Prefer the user-level config, or an input prompt for the key. VS Code can prompt you for a secret and store it, rather than leaving a literal key in a workspace file that might get committed.

What you get

Once connected, three tools appear in your assistant:

ToolWhat it does
search_parcelsRuns the same advanced search the site runs. Filter by county, owner, acreage, year built, zoning, sale date, value, vacancy, absentee owners, LLC and trust owners.
get_parcelPulls one parcel's full record. Always free, never counted.
get_accountReports your plan and what is left of your budget.

Budgets are shared with the site and the REST API. Every row a search returns counts, at any page size: 20,000 rows per day. Parcel lookups have their own separate count, 1,600 per day, so pulling one property's full record never eats into search. CSV exports are kept apart from both and keep their own rolling 7-day and 30-day budgets.

If it does not connect

What you seeWhat it means
401 UnauthorizedThe key is missing, mistyped or revoked. Check the header reads exactly Authorization: Bearer jbp_... with one space after Bearer.
402, or a message about your planThe key is valid but the account is not on Professional. API and connector access come with Professional.
405 Method Not AllowedSomething sent a GET. Our server speaks POST only. This almost always means the client is configured for SSE instead of streamable HTTP.
Connects, but no tools appearRestart the client. Most read MCP config once at startup.

Still stuck? Tell us what you are using and paste the error. We answer.

Other clients

Setup guides for Claude Code, Cursor, Gemini CLI, Windsurf and the plain REST API.