
MCP server for the Kooperativa API. Enrich and search professional profiles and companies, track
MCP server for the Kooperativa API. Enrich and search professional profiles and companies, track hiring signals and job changes, and manage webhook monitors, from any MCP-compatible AI assistant.
·
MCP (Model Context Protocol) server for the Kooperativa API.
Gives any MCP-compatible AI assistant (Claude Desktop, Kiro, Cursor, Windsurf, Kilo, etc.) direct access to Kooperativa's B2B data lake: enrich and search professional profiles and companies, surface hiring signals and recent job changes, resolve an email address to a profile, and manage webhook monitors, all from a conversation.
Kooperativa holds structured people and company records. It deliberately has no contact data: no email addresses and no phone numbers.
Requires Node.js 18+ and 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": "ik_live_..."
}
}
}
}No local installation step is required, npx resolves and runs the package on demand. Restart your MCP client after adding the config.
| 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_enrich_person_realtime | GET /person/realtime | Same, but from the live source. $0.001 per call, see Billing |
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_resolve_email | POST /resolve-email | Resolve an email address you already have to a profile |
kooperativa_institution_alumni | GET /institution/alumni | People whose education includes a given school |
kooperativa_enrich_company | GET /company | Full company profile lookup |
kooperativa_enrich_company_realtime | GET /company/realtime | Same, but from the live source. $0.001 per call, see Billing |
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_company_decision_makers | GET /company/decision-makers | C-level, VP and director profiles at a company |
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.
On connect the server sends the client a short brief (the MCP instructions field) covering the things that are easy to get wrong: the people and company industry taxonomies differ, countries are ISO 2-letter codes, a 404 means "not indexed yet", headcount figures can be unreliable, company-name search is fuzzy, and the realtime tools cost money. It also tells the model to treat profile text as untrusted data.
Every tool above is included in the workspace license, with no per-call charge, except the two realtime ones. Those read from the live source rather than from the Kooperativa data lake, and are metered at $0.001 per call on top of the license, which is still required.
This matters more here than in a hand-written integration, because the model decides when to call a tool. Three things follow from that:
503, meaning the source could not be reached at all, is not billed.kooperativa_enrich_person returns it afterwards at no cost.If you want to rule out metered spend entirely, do not expose the two *_realtime tools to the model.
The server looks for the key in this order:
KOOPERATIVA_API_KEY in the environment, when it has the shape of a real key (ik_live_...).~/.kooperativa/config.json by the login command (same file the Kooperativa CLI uses).The key is never logged, hardcoded, or transmitted anywhere other than as the Authorization: Bearer header on requests to https://kooperativa.io/api/v1.
loginSome MCP clients cannot pass a secret safely (they pass the text of a placeholder such as ${KOOPERATIVA_API_KEY} instead of expanding it, or do not inherit your shell environment). For those, run this once in a terminal:
npx -y @kooperativa_team/mcp-server loginIt asks for the key with input hidden, checks it against the API, and saves it with mode 0600. It prints only your account email and license state, never the key. Restart your MCP client afterwards. The client config then needs no env block at all.
An environment value that does not look like a key is ignored, so an unexpanded placeholder falls back to the stored key instead of causing a 401.
Never paste the key into a chat, a prompt, or a committed config file. Keep it in the login file, your MCP client's env block, or a secrets manager.
By default the server registers all 24 tools. Set KOOPERATIVA_MCP_TOOLSET=read to register only the 18 read-only data tools: no real-time (metered) lookups, no monitors (webhook subscriptions) and no email-to-profile lookup. The plugin and extension listings for Kiro, Cursor and Claude use this set.
{
"mcpServers": {
"kooperativa": {
"command": "npx",
"args": ["-y", "@kooperativa_team/mcp-server"],
"env": { "KOOPERATIVA_MCP_TOOLSET": "read" }
}
}
}Every tool carries a title and the MCP annotations readOnlyHint, destructiveHint, idempotentHint and openWorldHint. Responses are compact JSON, to keep token use low.
The package also ships kooperativa-mcp-http, a stateless Streamable HTTP server for clients that connect to a URL instead of spawning a process.
export KOOPERATIVA_API_KEY="ik_live_..."
export MCP_ACCESS_TOKEN="$(openssl rand -base64 32)"
npx -y -p @kooperativa_team/mcp-server kooperativa-mcp-http| Variable | Required | Default | Meaning |
|---|---|---|---|
MCP_ACCESS_TOKEN | yes | none | Bearer token every request must send. Without it the server refuses all requests (fail closed). |
KOOPERATIVA_API_KEY | yes | none | Your Kooperativa key, used for the upstream calls. |
PORT | no | 3100 | Listen port. |
HOST | no | 127.0.0.1 | Bind address. |
Security notes for self-hosting:
MCP_ACCESS_TOKEN spends your license and your realtime credits. Do not share the token or the URL.MCP_ACCESS_TOKEN if it is ever exposed.MIT
Pick your client and paste the snippet. Each one is the same server, written the way that client expects it.
claude mcp add kooperativa -- npx -y @kooperativa_team/mcp-server{
"mcpServers": {
"kooperativa": {
"env": {
"KOOPERATIVA_API_KEY": ""
},
"args": [
"-y",
"@kooperativa_team/mcp-server"
],
"command": "npx"
}
}
}code --add-mcp '{"name":"kooperativa","env":{"KOOPERATIVA_API_KEY":""},"args":["-y","@kooperativa_team/mcp-server"],"command":"npx"}'[mcp_servers.kooperativa]
command = "npx"
args = ["-y", "@kooperativa_team/mcp-server"]Runs locally on your device. Your client starts the server itself, so nothing has to be hosted.
Paste this prompt into your agent. It reads this page and does the setup for you.
Read https://aiagentslisting.com/mcp/kooperativa-mcp to learn what the "Kooperativa Mcp" MCP server does and how to install it. Add it to my coding agent's MCP configuration as documented on that page, then confirm the server connects and list the tools it exposes.Agents can also browse this directory over MCP at https://aiagentslisting.com/api/mcp
npx -y @kooperativa_team/mcp-server login| Name | What it does |
|---|---|
kooperativa_account_info | Get the authenticated Kooperativa account's email, license status (active/plan/expiry), and API usage this month/today, broken down by endpoint. Call this first if you're unsure whether the license is |
kooperativa_health_check | Simple liveness probe for the Kooperativa API. No authentication required. Use to verify connectivity before running a batch job. |
kooperativa_enrich_person | Look up a person's full professional profile (work history, education, skills, certifications, honors, publications, volunteering) from the Kooperativa data lake. Provide exactly one of linkedin_url, |
kooperativa_enrich_person_realtime | Fetch a person's profile from the live source instead of the Kooperativa data lake, so the answer reflects the profile as it is right now. COSTS $0.001 PER CALL, charged on top of the license, and eve |
kooperativa_check_person | Cheaply check whether Kooperativa already holds a given profile, without fetching the full record. Returns the matched id, full_name, and fetched_at on success, or 404 if not indexed yet. Use this to |
kooperativa_search_people | Search the Kooperativa data lake of professional profiles using any combination of filters (title, company, location, industry, seniority, headcount, skills, tenure, recent job change, past employer, |
kooperativa_bulk_enrich_people | Enrich up to 100 profiles in a single call. Pass an array where each item has exactly one of id, username, or linkedin_url. Unmatched identifiers are silently skipped and counted in not_found. |
kooperativa_person_colleagues | List a person's current colleagues (everyone else working at their current company right now). Useful for mapping org structure or finding an alternate contact at a target account. Requires the Kooper |
kooperativa_person_similar | Find people similar to a given person (same seniority, industry, and country), excluding themselves. Useful for lookalike audiences or finding alternative contacts at competing companies. Requires the |
kooperativa_person_job_changes | People who recently started a new job, a strong outreach signal (new role = new budget, new vendor decisions). Optionally filter to people who previously worked at a specific company_id. Sorted most-r |
kooperativa_resolve_email | Resolve an email address to a professional profile. Maps the email to a profile URL, then returns the profile from Kooperativa's own data lake (same shape and freshness as /v1/person). Returns 404 if |
kooperativa_institution_alumni | List people whose education history includes a given school, paginated. Prefer school_id (exact) when you have it. School name matching hashes the string as given, so 'NYU' and 'New York University' a |
kooperativa_enrich_company | Look up a company's full profile (headcount, follower count, founding year, HQ address, industries, specialities, office locations) from the Kooperativa data lake. Provide exactly one of linkedin_url, |
kooperativa_enrich_company_realtime | Fetch a company's profile from the live source instead of the Kooperativa data lake, so the answer reflects the company as it is right now. COSTS $0.001 PER CALL, charged on top of the license, and ev |
kooperativa_check_company | Cheaply check whether Kooperativa already holds a given company, without fetching the full record. Returns matched id, name, and fetched_at on success, or 404 if not indexed yet. |
kooperativa_search_companies | Search the Kooperativa data lake of companies by name, HQ location, industry, and headcount range. All filters are optional and combine with AND logic, but at least one filter is required. min_staff/m |
kooperativa_company_current_employees | List people currently working at a company, by its numeric company_id. Returns lightweight profile previews with offset pagination (total/pages). Pass a result's id to kooperativa_enrich_person for th |
kooperativa_company_past_employees | List people who previously worked at a company (held a role there, since moved on), by numeric company_id. Each result includes a past_positions array with the specific role(s) held there. Uses has_mo |
kooperativa_company_headcount_by_seniority | Breakdown of a company's indexed profiles by seniority level (c-level, vp, director, manager, individual). Useful for org intelligence and account qualification. Counts reflect only Kooperativa's inde |
kooperativa_company_hiring_signals | People who recently joined a company, a signal of growth, investment, or expansion. Sorted by join date descending, look-back window configurable in days (default 90, max 365). |
kooperativa_company_decision_makers | People at a company with seniority c-level, vp, or director, re-sorted most-senior-first. Manager is deliberately excluded. seniority is a comma-separated subset of 'c-level,vp,director' (default: all |
kooperativa_list_monitors | List all active webhook monitors for the authenticated workspace. |
kooperativa_create_monitor | Subscribe to change events on a professional profile or company URL. Kooperativa sends a signed POST to webhook_url whenever a change is detected (job change, title change, headline change, location c |
kooperativa_delete_monitor | Stop monitoring a profile or company and delete the monitor by its ID. |
Read live from the server on October 27, 2026.
Maintain this server? Claiming proves you own the listing and earns the last 4 points.
Claim this listingPaste this line near the top of your repository's README. The badge always renders the current score.
[](https://aiagentslisting.com/mcp/kooperativa-mcp)Nothing comparable is listed yet.
No tagged releases on record.
Connect to the AI Agents Listing MCP server at https://aiagentslisting.com/api/mcp using the HTTP transport and complete the sign-in when it asks. Then call the submit_review tool for the listing "kooperativa-mcp" with a rating from 1 to 5 and a short note on what worked and what did not.No reviews yet
Be the first to share your experience with this tool.
One email a week. New agents, MCP servers and skills, and what is actually getting traction.