# ParseAPI MCP server

> Enables AI agents to perform lookups for places, addresses, companies, email, phone, weather, and timezones.

- Repository: https://github.com/parseapi/mcp
- Page: https://hostedmcp.org/servers/parseapi/mcp
- Transport: stdio, remote
- Stars: 0
- Latest version: 1.12.4

## Install

### Claude Code

```sh
claude mcp add --env PARSEAPI_KEY=<YOUR_PARSEAPI_KEY> mcp -- npx -y parseapi-mcp
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "parseapi-mcp"
      ],
      "env": {
        "PARSEAPI_KEY": "<YOUR_PARSEAPI_KEY>"
      }
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "parseapi-mcp"
      ],
      "env": {
        "PARSEAPI_KEY": "<YOUR_PARSEAPI_KEY>"
      }
    }
  }
}
```

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "parseapi-mcp"
      ],
      "env": {
        "PARSEAPI_KEY": "<YOUR_PARSEAPI_KEY>"
      }
    }
  }
}
```

### Codex (`~/.codex/config.toml`)

```toml
[mcp_servers.mcp]
command = "npx"
args = ["-y", "parseapi-mcp"]

[mcp_servers.mcp.env]
PARSEAPI_KEY = "<YOUR_PARSEAPI_KEY>"
```

### Gemini CLI (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "parseapi-mcp"
      ],
      "env": {
        "PARSEAPI_KEY": "<YOUR_PARSEAPI_KEY>"
      }
    }
  }
}
```

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `PARSEAPI_KEY` | yes | yes | ParseAPI key from https://parseapi.com |
| `PARSEAPI_MCP_MODE` | no | no | Optional tool catalog mode: full (default) keeps named lookup tools; compact offers discover, preflight and lookup. |

## Tools (13)

- `stack`
- `domain`
- `dns`
- `asn`
- `card`
- `country_states`
- `address_search`
- `company_search`
- `company_id`
- `time`
- `time_zones`
- `date`
- `elevation`

## FAQ

### How do I use ParseAPI without installing anything?

You can use the hosted service by adding the server URL to your configuration and signing in via your browser.

### What tools are available in full mode?

Full mode provides 65 local lookup tools and 64 hosted lookup tools, including discover and preflight.

### How can I estimate costs before making a lookup?

You can use the preflight tool with a secret key to get account-specific estimates for operation counts.
