---
title: "KingMinos MCP Server"
description: "Streamable HTTP MCP for the KingMinos API. Connect at https://mcp.kingminos.com/mcp with a tenant Bearer key."
canonical: "https://kingminos.com/docs/mcp/"
sourceKind: "source-mdx"
---

Connect a coding agent to KingMinos at [`https://mcp.kingminos.com/mcp`](https://mcp.kingminos.com/mcp). The server is Streamable HTTP. It wraps the HTTP API at [`https://api.kingminos.com`](https://api.kingminos.com). One tool per live route.

It is not the OutboundSync product MCP. KingMinos pages stay on kingminos.com.

Auth is the same tenant Bearer as REST. Put the key in `KINGMINOS_API_KEY`. Clients send `Authorization: Bearer <your-key>`. A bare key is `401` `malformed`. Never print or commit the API key.

Sign in at [app.kingminos.com](https://app.kingminos.com/login/) to mint a `km_` token. See [Authentication](/docs/api/authentication/). The machine-readable HTTP contract is [`GET /openapi.json`](https://api.kingminos.com/openapi.json).

## Endpoint

| Field | Value |
| --- | --- |
| Endpoint | `https://mcp.kingminos.com/mcp` |
| Transport | Streamable HTTP |
| Health | `https://mcp.kingminos.com/health` |

## Connect

Add to `~/.cursor/mcp.json` (or project `.cursor/mcp.json`):

```json
{
  "mcpServers": {
    "kingminos": {
      "url": "https://mcp.kingminos.com/mcp",
      "headers": {
        "Authorization": "Bearer ${env:KINGMINOS_API_KEY}"
      }
    }
  }
}
```

Other Streamable HTTP clients use the same pair: URL and Bearer header.

Cursor GUI sessions do not inherit shell `.env` files. Export `KINGMINOS_API_KEY` into the GUI environment so `${env:KINGMINOS_API_KEY}` resolves.

## Tools

One tool per live route the MCP pin advertises. Capability POSTs spend credits. Confirm `put_credentials`, `delete_credentials`, and `delete_subject` with the user before calling them. `POST /v1/company/x-account` is on the HTTP API and in the capability catalog; it is not an MCP tool yet.

| Tool | Route | Notes |
| --- | --- | --- |
| `get_providers` | `GET /v1/providers` | |
| `get_capabilities` | `GET /v1/capabilities` | Catalog. A `200` proves the key. |
| `get_recipes` | `GET /v1/recipes` | Agent chaining recipes. Write guidance is `GET /v1/recipes/guidance`. |
| `company_resolve` | `POST /v1/company/resolve` | Name-only is `no_decision`. See [Company resolve](/docs/api/company-resolve/). |
| `company_b2b_social` | `POST /v1/company/b2b-social` | Paths `speed` / `balance` / `accuracy` / `coverage`. Domain required. See [Company B2B social](/docs/api/company-b2b-social/). |
| `company_icon` | `POST /v1/company/icon` | Hosted `https://logos.kingminos.com/i/<sha256>.png` or null. Favicon-fetch, then Brandfetch BYOK, then ZoomInfo. See [Company icon](/docs/api/company-icon/). |
| `company_description` | `POST /v1/company/description` | Paths `speed` / `balance` / `accuracy` / `coverage`. AI Ark firmographics; ZoomInfo BYOK on coverage. Stamp when `answer.confidence` meets the path floor. See [Company description](/docs/api/company-description/). |
| `company_domain` | `POST /v1/company/domain` | |
| `company_hierarchy` | `POST /v1/company/hierarchy` | |
| `person_verify_employment` | `POST /v1/person/verify-employment` | LeadMagic default. Findymail is BYOK-only. |
| `person_language` | `POST /v1/person/language` | English engagement and alternatives. See [Person language](/docs/api/person-language/). |
| `person_phone` | `POST /v1/person/phone` | One dialable number plus the ranked rest. See [Person phone](/docs/api/person-phone/). |
| `person_title` | `POST /v1/person/title` | Current title, seniority and function. See [Person title](/docs/api/person-title/). |
| `person_name` | `POST /v1/person/name` | Proper-cased first, last and full name. See [Person name](/docs/api/person-name/). |
| `person_b2b_social` | `POST /v1/person/b2b-social` | The person's LinkedIn profile URL from an email. See [Person B2B social](/docs/api/person-b2b-social/). |
| `get_run` | `GET /v1/runs/{id}` | |
| `submit_feedback` | `POST /v1/feedback` | Free, never costs credits. Not a support channel. File it when a call misses or comes back low-confidence, when you had to work around KingMinos, or when you wanted a field or provider we don't have. See [Feedback](/docs/feedback/). |
| `list_credentials` | `GET /v1/credentials` | Status only — never the secret. See [Vendor keys](/docs/api/credentials/). |
| `put_credentials` | `PUT /v1/credentials/{provider}` | Confirm with the user. See [Vendor keys](/docs/api/credentials/). |
| `delete_credentials` | `DELETE /v1/credentials/{provider}` | Confirm with the user. |
| `delete_subject` | `DELETE /v1/subjects/{subject_key}` | Confirm with the user. Requires the `erase` scope. |

## House keys vs vendor keys

LeadMagic, Wiza, Findymail, and AI Ark are house-key vendors. ZoomInfo, Brandfetch, BuiltWith, Prospeo, Apollo, Company URL Finder, People Data Labs, HG Insights, Enrich-CRM, Lemlist, and Snov.io (credentials only) are vendor keys you store (BYOK). Websearch and favicon-fetch are house-only and cannot be stored.

## MCP vs API vs Skills

| Surface | Best for |
| --- | --- |
| MCP (this page) | A coding agent calling KingMinos tools from Cursor or another Streamable HTTP client |
| [CLI](/docs/cli/) | `npx kingminos` against the HTTP API |
| API | Scripts and the OpenAPI contract at [`/openapi.yaml`](https://api.kingminos.com/openapi.yaml) |
| [Agent Skills](/docs/skills/) | Structured workflows (`auth`, `company-resolve`, `credentials`). Prefer REST. This pack does not ship the MCP server. |