# Use InstaVision from Claude, ChatGPT and your AI tools.

Connect it once as an MCP server. Then ask in plain words — your assistant runs the search, reads the proof and exports the list, on your credits.

## Connect

Server URL: https://instavision.co/api/connect/mcp

### claude.ai

1. **Add a custom connector.** In claude.ai, open Settings → Connectors and choose Add custom connector.
2. **Paste the server URL.** Name it InstaVision and paste the URL above. (https://instavision.co/api/connect/mcp)
3. **Sign in and ask.** Sign in to InstaVision when Claude asks, approve access, then describe who you need in any chat.

### ChatGPT

1. **Add a custom MCP server.** On chatgpt.com, open Plugins (chatgpt.com/plugins), select + and choose Add custom MCP server. No such option? Turn on Developer mode in Settings → Apps → Advanced settings; in a Business, Enterprise or Edu workspace an admin enables it.
2. **Paste the server URL.** Name it InstaVision, paste the MCP server URL above under Connection, and pick OAuth for authentication. Confirm the warning, then select Create as a plugin.
3. **Sign in and ask.** Sign in to InstaVision and approve access. In a new chat, type @, pick InstaVision and describe who you need. ChatGPT asks you to confirm before a search spends credits.

Needs a paid ChatGPT plan — Plus, Pro, Business, Enterprise or Edu. Add it on the web; it then works in your ChatGPT account.

### Grok Bot

1. **Ask Grok Bot to add it.** In a Grok Bot chat, write: “Add a custom MCP server called instavision at https://instavision.co/api/connect/mcp”. Say “custom”, or it looks for a marketplace plugin. Check the URL it shows and choose Add it.
2. **Sign in.** On the card Grok Bot posts, choose Authorize, sign in to InstaVision in the browser and approve access.
3. **Ask.** Type @, pick InstaVision and describe who you need. The server is shared by every Bot on your Grok account.

Sign-in keeps failing? Create a key in Settings → API keys and ask Grok Bot to add a custom MCP server at https://instavision.co/api/mcp/mcp with the header Authorization: Bearer <your key>. It keeps the key on the server entry, not in the URL.

### Claude Code

_Remote, with your API key in a header._ Paste into a terminal (bash or zsh) and press Enter. It then waits for your key: paste it and press Enter. The key isn't shown or saved to your shell history; Claude Code stores it in ~/.claude.json and makes the server available in every project.

Terminal:

```
read -rs INSTAVISION_API_KEY && claude mcp add --scope user --transport http instavision https://instavision.co/api/mcp/mcp --header "Authorization: Bearer $INSTAVISION_API_KEY"
```

### Cursor

_Remote, with your API key in a header._ Add to ~/.cursor/mcp.json, then restart Cursor. It reads the key from the INSTAVISION_API_KEY environment variable, so set that in the environment it starts from.

~/.cursor/mcp.json:

```
{"mcpServers":{"instavision":{"url":"https://instavision.co/api/mcp/mcp","headers":{"Authorization":"Bearer ${env:INSTAVISION_API_KEY}"}}}}
```

### Codex

_Remote, with your API key in a header._ Run in a terminal. It reads the key from the INSTAVISION_API_KEY environment variable, so set that in the environment it starts from.

Terminal:

```
codex mcp add instavision --url https://instavision.co/api/mcp/mcp --bearer-token-env-var INSTAVISION_API_KEY
```

### VS Code

_Remote, with your API key in a header._ Add to .vscode/mcp.json in your workspace. VS Code asks for the key once, when the server starts, and stores it for later.

.vscode/mcp.json:

```
{
  "inputs": [
    {
      "type": "promptString",
      "id": "instavision-api-key",
      "description": "InstaVision API key",
      "password": true
    }
  ],
  "servers": {
    "instavision": {
      "type": "http",
      "url": "https://instavision.co/api/mcp/mcp",
      "headers": { "Authorization": "Bearer ${input:instavision-api-key}" }
    }
  }
}
```

### Claude Desktop

_Through the instavision-mcp npx bridge (needs Node.js)._ Settings → Developer → Edit Config, add the block below with your key in place of iv_sk_..., then restart Claude Desktop. It runs the npx bridge, which needs Node.js.

claude_desktop_config.json:

```
{
  "mcpServers": {
    "instavision": {
      "command": "npx",
      "args": ["-y", "instavision-mcp"],
      "env": { "INSTAVISION_API_KEY": "iv_sk_..." }
    }
  }
}
```

On Windows, if npx fails to launch, use "command": "cmd" with "args": ["/c", "npx", "-y", "instavision-mcp"].

**Client asks for an API key instead?** Create one in Settings → API keys (https://instavision.co/settings/api-keys) and paste it there. Keep it private — it spends your credits.

## What your assistant can do

The same engine as the website. These are the tools it reaches for most; others manage your plan and the accounts you've already received.

- **Launch a search from a description** (`launch_discovery`) — A plain-language brief in, a running search out — with the spending cap you agreed.
- **Check status** (`get_run_status`) — How many found so far, and why it stopped.
- **Read results with proof** (`get_run_results`) — The matches with their reasons, page by page — profile text comes back as data, never as instructions.
- **Export PDF** (`export_run_pdf`) — A shareable PDF of the results, behind a link that expires after 1 hour.
- **Open extra matches** (`open_extra_matches`) — When a search verified more accounts than you asked for, open them at the price of a match each — with your yes.
- **Repeat a search weekly** (`set_weekly_search`) — The same brief every week, for accounts you don't have yet. You pay per verified match; turn it off anytime.
- **Check balance** (`get_balance`) — Credits left and your plan — with one link to subscribe when you have none.
- **Estimate credits** (`estimate_credits`) — The most a search can cost before you say yes. Works without an API key.

## Example conversation in Claude

> **You:** Find 5 roofing contractors in the US with no website that list a public email.
>
> **Claude:** That search can use up to 125 credits — 25 per verified match, nothing for rejects. You have 375. Shall I cap it at 125?
>
> **You:** Yes, go.
>
> **Claude:** Launched search · cap 125. Found 5 verified matches, 125 credits used. Top three: @summitroofing.atx, @ridgeline_roofs_oh, @bayoucityroofing.

_Illustration — the accounts and the conversation are made up._

## Searches spend your credits

- **A spending cap on every launch.** Every launch carries a cap you agree to — the search never goes past it. An agent's launch can hold at most 500 credits.
- **Hard limits per account.** No agent launch while 5 searches of the account are running, and at most 2,000 credits of agent launches in any 24 hours.
- **Disconnect anytime.** Disconnect claude.ai under Settings → API keys → Connected apps, or revoke a key there; the next request is refused.
- Only verified matches use credits. Possible matches and empty searches are free.

**No account yet?** 125 free credits + 375 with Google or a card — about 20 verified matches — they work from your assistant too. Start free: https://instavision.co/login
