@kooperativa_team/mcp-server

MCP (Model Context Protocol) server for the Kooperativa API.

Gives any MCP-compatible AI assistant (Claude Desktop, Kiro, Cursor, Windsurf, etc.) direct access to Kooperativa's B2B data lake: enrich and search professional profiles and companies, surface hiring signals and recent job changes, and manage webhook monitors, all from a conversation.

Installation

Requires a Kooperativa API key. Get one from your account dashboard.

Add the server to your MCP client's configuration:

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

No local installation step is required, npx resolves and runs the package on demand. Restart your MCP client after adding the config.

Available tools

Tool	Endpoint	Description
`kooperativa_account_info`	`GET /me`	License status and usage breakdown
`kooperativa_health_check`	`GET /health`	API liveness probe
`kooperativa_enrich_person`	`GET /person`	Full profile lookup by URL, username, or ID
`kooperativa_check_person`	`GET /person/check`	Cheap existence check before a full lookup
`kooperativa_search_people`	`POST /people/search`	Filtered search across the people data lake
`kooperativa_bulk_enrich_people`	`POST /people/bulk-enrich`	Enrich up to 100 profiles in one call
`kooperativa_person_colleagues`	`GET /person/colleagues`	Current coworkers of a person
`kooperativa_person_similar`	`GET /person/similar`	Lookalike profiles by seniority/industry/country
`kooperativa_person_job_changes`	`GET /person/job-changes`	Recently started new roles
`kooperativa_enrich_company`	`GET /company`	Full company profile lookup
`kooperativa_check_company`	`GET /company/check`	Cheap existence check before a full lookup
`kooperativa_search_companies`	`POST /companies/search`	Filtered search across the company data lake
`kooperativa_company_current_employees`	`GET /company/current-employees`	People currently at a company
`kooperativa_company_past_employees`	`GET /company/past-employees`	People who used to work at a company
`kooperativa_company_headcount_by_seniority`	`GET /company/headcount-by-seniority`	Indexed headcount breakdown
`kooperativa_company_hiring_signals`	`GET /company/hiring-signals`	Recently joined employees
`kooperativa_list_monitors`	`GET /monitors`	List active webhook monitors
`kooperativa_create_monitor`	`POST /monitors`	Subscribe to change events on a profile/company
`kooperativa_delete_monitor`	`DELETE /monitors`	Remove a webhook monitor

Full parameter reference: docs.kooperativa.io.

Authentication

The server reads KOOPERATIVA_API_KEY from the environment. It is never logged, hardcoded, or transmitted anywhere other than as the Authorization: Bearer header on requests to https://kooperativa.io/api/v1.

License

MIT

Support

support@kooperativa.io