MCP

Give your AI the same lookups you use in code.

57 tools. Your existing plan. Connect once, then ask.

Connect your AI

Add the server. The browser asks once.

  • Cursor

    Open Cursor, add the server, and finish browser sign-in.

    Add
  • VS Code

    Review the server in VS Code, then finish browser sign-in.

    Add
  • Claude · The app

    Add the connector, then choose Connect to authorize it.

    Add
  • Claude Code · The terminal

    Run the command, then use /mcp in Claude Code to sign in.

  • ChatGPT

    Create a custom app in developer mode. Choose OAuth and paste the URL.

Manual setup and client guides
MCP server URL
https://mcp.parseapi.com

Cursor: add this to .cursor/mcp.json in your project. Merge it with any existing servers. Cursor guide.

Cursor · .cursor/mcp.json
{
  "mcpServers": {
    "parseAPI": { "url": "https://mcp.parseapi.com" }
  }
}

VS Code uses a different config shape. Add this to .vscode/mcp.json, merging existing servers. VS Code guide.

VS Code · .vscode/mcp.json
{
  "servers": {
    "parseAPI": {
      "type": "http",
      "url": "https://mcp.parseapi.com"
    }
  }
}
Claude Code · terminal command
claude mcp add --transport http parseAPI https://mcp.parseapi.com
Run this in your terminal. In Claude Code, use /mcp to finish sign-in. Claude Code guide.

Claude app: add the server URL as a custom connector, choose Connect, then enable it in your chat. Claude guide.

ChatGPT: create a custom app in developer mode with this URL and OAuth, then enable the app in your conversation. Access depends on your account and workspace settings. ChatGPT guide.

CI, API keys, and local stdio

Headless clients can send a secret API key in X-API-Key. Replace the placeholder below with your key. AI setup has ready-to-copy configuration for your account.

Remote HTTP · mcpServers config
{
  "mcpServers": {
    "parseAPI": {
      "url": "https://mcp.parseapi.com",
      "headers": { "X-API-Key": "parse_YOUR_SECRET_KEY" }
    }
  }
}

For a client that runs a local stdio server, use npx parseapi-mcp with PARSEAPI_KEY set. This configuration requires Node.js and a client that accepts mcpServers.

Local stdio · mcpServers config
{
  "mcpServers": {
    "parseAPI": {
      "command": "npx",
      "args": ["-y", "parseapi-mcp"],
      "env": { "PARSEAPI_KEY": "parse_YOUR_SECRET_KEY" }
    }
  }
}

Keep configurations containing a secret key out of shared repositories. Key guide.

Make your first call

Once connected, enable ParseAPI in your conversation and paste a prompt. These examples use ordinary lookups from your request allowance. Free works.

Paste this into your AI
Use the ParseAPI postal tool to look up 28202 with country US. Show the returned JSON.

A successful call: Look for a postal tool call and JSON containing postal, city, state and country. The country should be US.

Read the postal response reference ↗

Your AI should call the named tool and use its response. If it answers without a tool call, check that ParseAPI is enabled for the conversation.

Find the right tool

Search the hosted server by name, input, or what you need. Each reference explains the response and its limits.

8 common tools · 57 available

  • postal

    Reference ↗

    Resolve a postal code to its place, coordinates and timezone. Deep adds area, population with its reporting period, tax references, neighbors and metro associations on paid plans. property_tax is a nullable area statistic with annual_median, currency and period: median annual tax payable on owner-occupied homes, adjusted to the final year of the period. It is not a rate or property bill. Unsupported, missing and censored estimates are null. Tax rates are percentages and alternative geographic references, not additive.

    Inputs: code, country (optional), deep (optional)

  • phone

    Reference ↗

    Parse and validate a phone number with national and international display formats. Deep adds numbering-plan state and timezone on every plan. These do not locate a handset.

    Inputs: country (optional), deep (optional), number

  • email

    Reference ↗

    Check email syntax, mail routing, consumer mailbox, disposable and role flags, reserved domain type, and known domain typos. Deep checks mailbox deliverability and catchall behavior. Recent mailbox results can be reused.

    Inputs: deep (optional), email

  • ip

    Reference ↗

    Look up an IPv4 or IPv6 address: country, continent, ASN and network. Paid deep adds location details when available, plus datacenter, relay, Tor and VPN flags.

    Inputs: deep (optional), ip

  • address

    Reference ↗

    Look up a US street address. Returns validation, an official-record match, standardized parts and coordinates where available. A record match does not establish postal deliverability.

    Inputs: address, country (optional), deep (optional)

  • point

    Reference ↗

    Find the country, state, district and timezone at coordinates. Deep adds terrain elevation and a compact nearest-city summary, included on every plan.

    Inputs: deep (optional), lat, lon

  • currency_rate

    Reference ↗

    Reference exchange rate between two currencies. Pass date for a past business day, amount to convert.

    Inputs: amount (optional), base, date (optional), quote

  • time

    Reference ↗

    Current local time, Unix seconds, exact UTC offset and DST. Omit timezone for UTC or pass both coordinates. at selects the moment; to converts it. Deep adds friendly name, numeric offsets and the next source clock transition on every plan.

    Inputs: at (optional), deep (optional), lat (optional), lon (optional), timezone (optional), to (optional)

Same API. Same plan.

Tools return the API's JSON. They look up data without editing your records. Calls count against your plan's usage, with no separate MCP subscription.

Start includes 1M API requests a month for $20/mo.

Metered lookups and metered deep checks use their own included allowances. On-demand charges apply when enabled. Check the tool's reference before asking an agent to run a large list.

How usage worksCore and deepCompare plans

Get unstuck

The app did not open, or I cannot add a connector

Use manual setup and the guide for your client. Desktop install links need the matching app installed. Custom connectors may need to be enabled by your workspace admin.

I connected, but my AI is not using the tools

Finish browser authorization, enable ParseAPI in the client, and try the postal prompt. In Claude Code, use /mcp to check the connection. A typed answer alone does not confirm a tool call.

A tool returns an error

Read the returned code and message. invalid_api_key needs a reconnect or a valid key. quota_exceeded needs available allowance. For a rate limit, pause before retrying.

Error reference · Retry guidance. Unknown values can be null, and validation can return valid: false without an error. How to read responses.

I want to disconnect a client

Revoke its connection in AI setup. A revoked connection can take up to 10 minutes to stop working. For a setup using your own API key, revoke that key in Keys.

Building with a coding agent? Give it the agent integration guide and the SDK reference.

MCP source · Cursor directory · Email