Zooq

Add Zooq to any MCP-compatible client (Claude Desktop, Cursor, Codex, Hermes, Openclaw) and your agent gets the full Zooq catalog: all 44 endpoints wrapped as credit-billed MCP tools.

Open~/Library/Application Support/Claude/claude_desktop_config.json(macOS) or%APPDATA%/Claude/claude_desktop_config.json(Windows) and merge:

{ "mcpServers": { "zooq": { "url": "https://zooq.dev/api/mcp", "headers": { "X-API-Key": "zq_..." } } } }

Replacezq_...with your key from/dash. Restart Claude. The tools appear in the tools menu under "zooq".

{ "mcp": { "servers": { "zooq": { "url": "https://zooq.dev/api/mcp", "headers": { "X-API-Key": "zq_..." } } } } }

[mcp_servers.zooq] url = "https://zooq.dev/api/mcp" http_headers = { "X-API-Key" = "zq_..." }

Edit~/.hermes/config.yaml— merge undermcp_servers:

mcp_servers: zooq: url: "https://zooq.dev/api/mcp" headers: X-API-Key: "zq_..." enabled: true

Edit~/.openclaw/openclaw.json— merge into the root object (or runopenclaw mcp set zooq '<json>'):

{ "mcp": { "servers": { "zooq": { "url": "https://zooq.dev/api/mcp", "headers": { "X-API-Key": "zq_..." } } } } }

The full catalog — 44 endpoints across 8 categories, every one of them callable from your MCP client. Tool names follow the conventioncategory_endpoint(e.g.profile_full,companies_info_v2,search_jobs).

Resolve a company slug to the numeric organization id used by the live company endpoints (posts, similar, affiliated, insights). Resolve once, reuse the id.

Resolve a company slug (the part after linkedin.com/company/) to its stable org_ id — the dataset id used by /companies/info. For the live company endpoints (posts, similar, affiliated, insights) use /api/v1/companies/entity-id instead; the two ids are not interchangeable. Returns the FULL company record (identical to /companies/info) — read data.id.

Full company firmographics — description, industry, headcount, HQ, follower count, specialties.

Freshest LIVE company profile. Returns three things the dataset record behind /api/v1/companies/info does not: funding signals, the FULL location list (not just HQ), and parent/affiliated/related pages. Pass slug and Zooq resolves it to the numeric id at no extra credit cost, or pass id from /api/v1/companies/entity-id to skip the lookup. Not-found is free upstream.

Search companies by name, with the full firmographic filter set. Cursor-paginated. Same upstream as /api/v1/search/companies — use whichever entry point reads better; they are equivalent.

People who work or worked at an organization (professional records, same shape as /search/people). Cursor-paginated.

Similar companies / peers (id, name, industry, followers, url). Keyed by the numeric organization id: pass slug and Zooq resolves it for you at no extra credit cost, or pass id from /api/v1/companies/entity-id to skip the lookup.

Affiliated / subsidiary / showcase pages of a company. Keyed by the numeric organization id: pass slug and Zooq resolves it for you at no extra credit cost, or pass id from /api/v1/companies/entity-id to skip the lookup.

Employee-count total + distribution buckets (by department, seniority, location). Keyed by the numeric organization id: pass slug and Zooq resolves it for you at no extra credit cost, or pass id from /api/v1/companies/entity-id to skip the lookup.

A company's recent posts. data.activities[].entityId is the activity id consumed by /posts/info, /posts/comments, /posts/likes. Keyed by the numeric organization id: pass slug and Zooq resolves it for you at no extra credit cost, or pass id from /api/v1/companies/entity-id to skip the lookup.

Open job postings across one or more organizations.

Check whether an email address can receive mail, with a deliverability verdict and risk flags (catch-all, disposable, no-MX).

Discover a person's work email from their first name, last name, and company domain. Returns the address plus a confidence score.

Identify a person and their current company from a professional profile URL (or handle), then find their work email — resolves name + domain for you.

Resolve the person and company behind a BUSINESS email address. Public/role/disposable mailboxes are rejected (422, no charge) before any work runs.

Page emails already known for a company domain. Cursor-paginated; returns up to 20 contacts per page with first/last name.

Full job-posting details — title, description, functions, apply url, organization, location.

Similar job postings (title, organization, location, salary range, posted date).

'People also viewed' postings (behavioral relatedness).

Hiring-team member profiles for a posting. Empty members can mean the posting genuinely lists no team OR the posting id was not recognized.

Job postings created by a person (e.g. a recruiter's or founder's open roles).

Skill catalog search by name (partial match) — skills only, despite the endpoint name. Page-paginated. Use to find a skill's skl_ id or normalized_name for the /search/people skills filter.

Resolve one institution by its normalized name — returns the school name, url, and stable inst_ id. Get the normalized_name from /api/v1/search/schools first.

Resolve one skill by its stable skl_ id — returns the display name and normalized name. Get the id from /api/v1/g/title-skills-lookup (skill search).

A person's recent posts / activity stream. Cursor- or offset-paginated. Keyed by the person entityId: pass handle and Zooq resolves it for you at no extra credit cost, or pass entityId from /api/v1/profile/entity-id to skip the lookup.

Full content of one post (returned under data.post). For comments use /posts/comments.

People who reacted to a post + reaction type and total.

Complete profile in one call — positions, education, skills, certifications, geo, follower/connection counts and flags. This is the canonical profile read; the other profile/ paths (overview, details, about, education, skills, certifications, full-experience, social-matrix) are named aliases that return this exact same record.

Freshest LIVE snapshot of one profile, by handle or entityId — not the deduplicated dataset record the other profile/ endpoints return. Carries live-only flags (openToWork, isHiring, isTopVoice) and returns the person's entityId, the id every other live person endpoint needs.

Complete LIVE work history for one person: per-role organization, title, description, location, parsed dates, per-role skills, and parallel-position groupings (concurrent titles kept distinct rather than flattened). Overlaps /api/v1/profile/full-experience, which reads the dataset record — use this when you need freshness, per-role skills, or correct handling of concurrent roles. Pass handle and Zooq resolves it at no extra credit cost, or pass entityId from /api/v1/profile/entity-id to skip the lookup. Not-found is free upstream.

Recommendations written for the person, with author details and text.

Similar professional profiles — expand a shortlist from one example.

Entities the person follows (companies, groups, people, newsletters).

Search professional records with rich filters — name, title, company, skills, education, tenure, geography. Cursor-paginated.

Search organizations by name or website with firmographic filters. Cursor-paginated.

Job/opportunity search with the full filter set. Location filtering works: pass locations a LinkedIn geo id (e.g. 101570771 for Tel Aviv-Yafo) — see that parameter for how to find one, and note it is an EXACT match, so use a city id rather than a country id. Still id-typed and not yet usable: titles, industries, functions, benefits, commitments. Offset-paginated. data.jobs[].id is the opportunityEntityId consumed by /jobs/details-v2, /jobs/similar, /jobs/people-also-viewed, /jobs/hiring-team.

LIVE people search — the only endpoint that filters by current company, past company AND school together. Complements /api/v1/search/people (the deduplicated dataset, cursor-paginated, plain-string geo): use this one for company-history sourcing, that one for broad firmographic filtering. Offset-paginated. Not-found is free upstream.

LIVE company search. Its draw is hasJobs — an actively-hiring filter available nowhere else in the catalog — plus bucketed headcount search. For firmographic filtering (staff/follower counts, founded year, website) use /api/v1/search/companies instead. Offset-paginated. Not-found is free upstream.

Search institutions by name (partial match). Page-paginated. Use to discover an institution's inst_ id or normalized_name.

Recent professional job-change events — people who joined, left, or changed titles at organizations. Page-paginated. Built for trigger-based prospecting and territory monitoring.

Alumni and current students of an institution (professional records + the education link). Page-paginated. Built for recruiting and warm-intro sourcing.

Every tool costs the same per-call rate as its REST counterpart — check your live balance and per-call cost on/dash.

Suspect your key leaked? Open/dashand regenerate. The old key stops working immediately.

Every MCP tool call deducts credits live, same as the REST API. No monthly minimum, no surcharge for MCP. See/pricingfor the credit pack and subscription tiers.

- Tools don't appear in client:restart the app fully (quit, don't just close). Verify your config JSON is valid.
- "Invalid API key":double-check you copied the full key from/dash(it starts withzq_).
- "Insufficient credits" / "Payment required":top up at/billing.
- "Hourly credit cap reached":default is 10,000/h. Emailhello@zooq.devto raise it.
- Tool returns no data:the upstream might be temporarily degraded — check/status. If 5xx, your credits are auto-refunded.

Rolls hiring and tech-stack signals into a single go-to-market fit score for fast account prioritization. Part of the Mamba Labs signal toolkit.