Zooq MCP Server

LinkedIn-data API and MCP server for AI agents: public profiles, companies, and posts as clean JSON, no login, 300 free credits.

View on zooq.dev

Documentation

Zooq Founders is live: $19 for 5,000 credits + 30% off foreverFirst 100 customers onlyServer-enforced capNo card needed to sign up, claim laterZooq Founders is live: $19 for 5,000 credits + 30% off foreverFirst 100 customers onlyServer-enforced capNo card needed to sign up, claim laterZooq Founders is live: $19 for 5,000 credits + 30% off foreverFirst 100 customers onlyServer-enforced capNo card needed to sign up, claim later

Zooq's MCP server

Add Zooq to any MCP-compatible client (Claude Desktop, Cursor, Codex, Hermes, Openclaw, Windsurf) and your agent gets the full Zooq catalog — all 52 endpoints wrapped as credit-billed MCP tools. Same API key as the REST endpoints, same atomic per-call billing, same instant refund on upstream errors.

Polishing in progress

The MCP server is live and credit-deducting. We're finishing the in-dash management UI (tool browsing, per-key scope limits, usage analytics). Everything below works today.

What is MCP?

Model Context Protocol is Anthropic's open standard for letting AI clients (Claude, etc.) discover and call external tools at runtime. Instead of you writing API wrappers in your agent code, your agent reads a list of tools from an MCP server and calls them directly via JSON-RPC. Zooq exposes its data endpoints this way.

Why it's safe to install

Hourly burn cap

A leaked key can't drain your balance — the server enforces a max-credits-per-hour limit per user (default 500/h). Even a compromised key's damage is bounded.

Atomic credit deduction

Every tool call deducts credits atomically. Upstream returns 5xx? Credits auto-refund within seconds. No retries that double-charge.

Strict arg whitelist

Tool arguments are matched against the endpoint's declared schema. Unknown keys are dropped; oversized values truncated. Stops injection attempts into the upstream proxy.

Revocable in one click

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

Available tools

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

Articles (3)

articles_all

User articles.

articles_info

Article by URL.

articles_reactions

Article reactions.

Comments (2)

comments_all

All comments by user.

comments_likes

Comment likes.

Companies (10)

companies_universal_name_to_id

Resolve a company's universal name (the slug in linkedin.com/company/) to its numeric company ID.

companies_info

Full company profile — description, LinkedIn URL, universal name, and more.

companies_info_v2

Extended company profile (data nested under a `company` object).

companies_name_lookup

Autocomplete companies by name.

companies_jobs

Open jobs at this company.

companies_affiliated_pages

Affiliated company pages.

companies_insights

Premium company insights.

companies_posts

Posts published by the company page.

companies_similar

Similar companies.

companies_employees_data

Employee insights.

Geos (1)

geos_name_lookup

Resolve a location name to a Geo ID.

Jobs (6)

jobs_details_v2

Job details (any status).

jobs_similar

Similar jobs.

jobs_people_also_viewed

Related jobs.

jobs_hiring_team

People who posted the job.

jobs_posted_by_profile

Jobs posted by user.

jobs_funcs_lookup

Job-function autocomplete.

Lookups (3)

g_title_skills_lookup

Resolve skill or title names to LinkedIn IDs.

g_services_lookup

Resolve service names to IDs.

g_industry_lookup

Resolve industry names to IDs.

Posts (5)

posts_featured

Featured posts by user.

posts_all

All posts by user.

posts_info

Post details.

posts_comments

Post comments.

posts_likes

Post reactions.

Profile (16)

profile_overview

Basic profile by LinkedIn username.

profile_full

Complete profile in one call (experience, education, skills).

profile_details

Detailed profile by URN.

profile_contact_info

Email/phone (only what the user has made public).

profile_full_experience

Full work history.

profile_education

Education history.

profile_skills

Skills list.

profile_certifications

Certifications.

profile_services

Services offered by this profile.

profile_about

Profile metadata (location, industry, etc).

profile_social_matrix

Followers + connections counts.

profile_recommendations

Given/received recommendations.

profile_similar

Similar profiles.

profile_reactions

All reactions by this user.

profile_interests

User-declared interests.

profile_username_to_urn

Resolve a username to a stable URN.

Search (6)

search_people

Search people with rich filters — name, title, current/past company, location, industry, school, and more.

search_companies

Search companies with filters — keyword, location, size, industry, hiring status.

search_jobs

Job search with the full LinkedIn filter set — location, salary, experience, work type, and more.

search_posts

Search posts with author and content filters.

search_services

Search services offered by professionals.

search_schools

Search schools.

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

Install in Claude Desktop

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_..." } } } }

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

Install in Cursor

Cursor settings → MCP → paste:

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

Install in Codex

Edit ~/.codex/config.toml — append:

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

Install in Hermes

Edit ~/.hermes/config.yaml — merge under mcp_servers:

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

Install in Openclaw

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

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

Usage examples

Once installed, your agent sees every tool listed above. Sample prompts and the tool the agent will pick:

  • "Get me the full LinkedIn profile of satyanadella" → profile_full
  • "What does Stripe's LinkedIn page say?" → companies_name_lookup then companies_info
  • "Find 10 VPs of Engineering at SaaS companies in San Francisco" → search_people
  • "Pull every open role at Microsoft" → companies_universal_name_to_id then search_jobs with companies filter
  • "Map the headcount growth of company X over the last year" → companies_insights

Agents can chain tools natively — the MCP protocol exposes the full parameter schema so the model knows which ID to pass where.

Pricing

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

Troubleshooting

  • 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 with zq_).
  • "Insufficient credits" / "Payment required": top up at /billing.
  • "Hourly credit cap reached": default is 500/h. Email [email protected] to raise it.
  • Tool returns no data: the upstream might be temporarily degraded — check /status. If 5xx, your credits are auto-refunded.

Get an API key →