Back to integrations
MCP server4 min read

Kooperativa MCP Server for AI Assistants

For anyone using an MCP-compatible AI assistant who wants Kooperativa data available as a tool call.

@kooperativa_team/mcp-serverView package

MCP (Model Context Protocol) is the emerging standard for giving an AI assistant tools it can call directly, rather than pasting a curl command into a chat and copying the output back. The Kooperativa MCP server wraps the whole API, person and company enrichment, search, hiring signals, job changes, and webhook monitors, as a set of typed tools any MCP client can call.

It runs locally over stdio and is installed with a single `npx` command in your MCP client's config, no separate install step, no server to host. The only setup is an API key, read from an environment variable and never hardcoded, logged, or sent anywhere other than as the Authorization header on requests to the Kooperativa API.

What it exposes

Every tool maps to a real endpoint, not a simplified subset: enrich and search people and companies, list current and past employees at a company, find colleagues and lookalike profiles, pull recent job changes and hiring signals, break down headcount by seniority, and create, list, or delete webhook monitors. The full list, and which endpoint each tool calls, is in the package README.

Why this over a raw API call from inside a chat

An assistant with the MCP server configured can decide on its own when to call `kooperativa_enrich_person` or `kooperativa_search_people` mid-conversation, chain a search result into an enrichment call, or check a company's hiring signals before drafting outreach, all without you writing or running a script. That is the difference between an assistant that can discuss an API and one that can actually use it.

Because the license is flat-rate rather than credit-metered, there is no cost calculation involved in letting an assistant make a few extra exploratory calls while working through a task, the same rate limit applies whether the client calling the API is a script or a conversation.

MCP client configjson
{
  "mcpServers": {
    "kooperativa": {
      "command": "npx",
      "args": ["-y", "@kooperativa_team/mcp-server"],
      "env": {
        "KOOPERATIVA_API_KEY": "kk_live_..."
      }
    }
  }
}

Get started

Try Kooperativa

One API key. Every endpoint behind this integration, and every other one, included on the same flat license with unlimited requests.

More integrations