# Klinio, inside your AI.

Find companies and their emails and phones from Claude, Codex, Cursor or any MCP client: the same searches and credits as the site, the free daily ones included.

- Server: https://klinio.io/api/mcp

## 1. Create your API key

Sign in with Google and create a key on the API page. It starts with kl_live_ and acts as your account; a free account’s daily credits work here too. [Open the API page](https://klinio.io/developers)

## 2. Add Klinio to your client

### Claude Code
```bash
claude mcp add --transport http klinio https://klinio.io/api/mcp \
  --header "Authorization: Bearer YOUR_KEY"
```

### Codex
```bash
export KLINIO_API_KEY=YOUR_KEY
codex mcp add klinio --url https://klinio.io/api/mcp \
  --bearer-token-env-var KLINIO_API_KEY
```

### Cursor (~/.cursor/mcp.json)
```json
{
  "mcpServers": {
    "klinio": {
      "url": "https://klinio.io/api/mcp",
      "headers": { "Authorization": "Bearer YOUR_KEY" }
    }
  }
}
```

### VS Code (.vscode/mcp.json)
```json
{
  "inputs": [
    { "type": "promptString", "id": "klinio-key", "description": "Klinio API key", "password": true }
  ],
  "servers": {
    "klinio": {
      "type": "http",
      "url": "https://klinio.io/api/mcp",
      "headers": { "Authorization": "Bearer ${input:klinio-key}" }
    }
  }
}
```

### Gemini CLI
```bash
gemini mcp add --transport http \
  --header "Authorization: Bearer YOUR_KEY" \
  klinio https://klinio.io/api/mcp
```

### Claude Desktop (claude_desktop_config.json)
```json
{
  "mcpServers": {
    "klinio": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://klinio.io/api/mcp",
               "--header", "Authorization:${KLINIO_AUTH}"],
      "env": { "KLINIO_AUTH": "Bearer YOUR_KEY" }
    }
  }
}
```

Put your key where it says YOUR_KEY. Codex reads it from the KLINIO_API_KEY environment variable, and VS Code asks for it the first time. Any other client that speaks MCP over HTTP: use the server address above and send the header Authorization: Bearer YOUR_KEY.

## What it can do

- `google_maps_email_extractor`: Google Maps email extractor. Type a kind of business and a place. (1 credit per company with contacts)
- `website_email_finder`: Website email finder. Paste one website or a whole list. (1 credit per company with contacts)
- `google_search_email_extractor`: Google search email extractor. Paste the link of a Google search. (1 credit per company with contacts)
- `clutch_email_extractor`: Clutch email extractor. Paste a Clutch directory link. (1 credit per company with contacts)
- `get_search`: Follow a search until it is done. (No credits)
- `get_results`: Read the companies a search found: website, emails, phones. (No credits)
- `list_searches`: Your history: searches from the site, the extension, the API and here. (No credits)
- `stop_search`: Stop a search. What it found stays. (No credits)
- `get_account`: Your plan and the credits you have left. (No credits)

No price of its own: a search spends your account’s credits, one per company with an email or phone, as on the site. A free account has 10 credits a day. Up to 3 searches at once and 120 requests a minute per key.

## Things to ask

- Find dentists in Berlin with their emails and phones, and give me a table.
- Get the emails of these 30 company websites and tell me which have none.
- Find web design agencies in Ankara, then sum up how many have both a phone and an email.
- Take this Clutch link and list the agencies with a contact email.
- Show my last 10 searches and the companies with contacts from the newest one.
- How many credits do I have left today?

- [Pricing](https://klinio.io/pricing)
- [API](https://klinio.io/developers)
- [MCP server](https://klinio.io/developers/mcp)
- [Google Maps email extractor](https://klinio.io/google-maps-email-extractor)
- [Website email finder](https://klinio.io/website-email-finder)
- [Google search email extractor](https://klinio.io/google-search-email-extractor)
- [Clutch email extractor](https://klinio.io/clutch-email-extractor)
- [LinkedIn company finder](https://klinio.io/linkedin-company-email-finder)
- [Extension privacy](https://klinio.io/extension-privacy)

---
Page: https://klinio.io/developers/mcp
Markdown: https://klinio.io/developers/mcp.md
