Build on Employbl data
Connect Claude Desktop and other AI assistants to Employbl's30,000+ companies, 75,000+ jobs, and 75,000+ funding rounds via the Model Context Protocol.
Connect in two steps
1. Sign in with OAuth (recommended)
The server URL is https://www.employbl.com/api/mcp. No manual token setup needed — your client opens a browser window where you sign in to Employbl and click Authorize.
Claude Desktop or claude.ai: Settings → Connectors → Add custom connector, paste the server URL above, then complete the sign-in prompt.
Claude Code: run the command below, then use /mcp inside a session to authenticate.
claude mcp add --transport http employbl https://www.employbl.com/api/mcp
2. Or use an access token
For clients without an OAuth flow, generate a permanent access token at Profile → MCP and pass it as a Bearer header. The token authenticates all MCP and REST API requests and is rate-limited per token.
{
"mcpServers": {
"employbl": {
"url": "https://www.employbl.com/api/mcp",
"headers": {
"Authorization": "Bearer YOUR_TOKEN_HERE"
}
}
}
}Replace YOUR_TOKEN_HERE with your token. Either way, an Employbl Premium account (or active trial) is required.
Available tools (27)
All tools are premium-gated and rate-limited. Use natural language with Claude to invoke them — you don't need to memorize the exact names or parameters.
Company Search & Discovery
find_companies
Search Employbl's index of 30,000+ American companies. Filter by name, city, zip, state, distance from any US location, job-feed coverage, funding round, sector/subsector (curated industry taxonomy), tech stack, investors, and company size. Location filters combine freely with every other filter, and they match satellite offices as well as headquarters. Tech-stack filtering matches technologies extracted from each company's live job descriptions (2,400+ companies) in addition to company-reported stacks.
› "Which Series A companies are in zip code 94133?"
get_company
Fetch a single company's full profile by slug. Returns description, address, employee range, full funding history, social links, open role count, and premium fields like tagline, tech stack, and FAQ.
› "Get the full profile for Anthropic"
find_companies_near_me
Find the tech companies nearest to any US location, sorted by distance. Give a street address, city + state, or zip code — matched against 29,000+ geocoded company offices. Returns distance in miles, open role count, and profile links. Optional radius, funding-round, company-size and synced-listings-only filters. Use find_companies instead when distance ordering doesn't matter.
› "Which Series A startups within 10 miles of Oakland have open roles on Employbl?"
find_similar_companies
Look up a company by name or domain and discover curated similar companies. Useful for competitive analysis, exploring a market segment, or finding alternative employers.
› "Show me companies similar to Stripe"
compare_companies
Compare 2-5 companies side-by-side: what they do, HQ, founded year, size, total raised, latest round, open roles, work model, tech stack, and notable investors — as one table.
› "Compare Anthropic, OpenAI, and Mistral as employers"
summarize_company
Generate a concise, AI-powered narrative summary of a company. Covers what they do, stage, investors, and why an engineer might want to work there. Uses your monthly AI token allowance or BYOK key.
› "Summarize OpenAI for me"
Job Search
search_jobs
Search Employbl's index of 75,000+ active job listings. Filter by title, location, remote status, seniority, salary, posting recency, company stage, company size, industry, tech stack, investors, and job tags.
› "Find remote senior engineering jobs at AI companies paying $180k+"
get_job_listing
Fetch a single job listing's full details by id, including the complete job description (truncated to ~4K chars).
› "Get full details for job listing 12345"
Funding & Market Intelligence
recent_funding_rounds
List recent venture funding rounds across 30,000+ companies and 75,000+ rounds. Filter by date range, round name, minimum USD amount, location, and job-feed coverage. Defaults to the last 90 days. A company with no synced roles may still be hiring — recently funded companies are the least likely to be covered. Every response states the date funding data is current through.
› "Show me companies in NYC that raised Series B in the last 6 months"
AI-Powered Search
personalize_search
Interprets natural-language job search requests and recommends the most relevant search parameters. Optionally factors in work model, seniority, and location preferences. Uses your AI token allowance or BYOK key.
› "I want to find startup jobs in climate tech where I can work remotely"
Profile Management
get_profile
Fetch your complete profile including basic info, work experience, education, projects, certifications, and skills. Optionally specify which sections to retrieve.
› "Show me my work experience and skills"
update_profile
Update your basic profile information including name, job title, location, summary, LinkedIn, GitHub, personal website, and avatar.
› "Update my profile: I'm now a Staff Engineer at Anthropic in San Francisco"
add_work_experience
Add a work experience entry to your profile with title, company, dates, and description.
› "Add my last job: Senior Engineer at Google from Jan 2020 to Dec 2023"
add_skills
Add or update your technical skills. This replaces your existing skills list with the provided skills.
› "Add my skills: Python, TypeScript, PostgreSQL, AWS, Docker, Kubernetes"
upload_profile_from_text
Build your entire profile from pasted text in one step. Paste a resume, LinkedIn About section, or bio — AI extracts your basic info, work history, and skills and writes them to your profile, then reports what's still missing. Uses your AI token allowance or BYOK key.
› "Here is my resume [paste] — set up my Employbl profile from it"
Job Search Preferences
get_preferences
Retrieve your job search preferences including target seniority, industries, company stages, locations, skills, and minimum compensation.
› "Show me my current job search preferences"
update_preferences
Update your job search preferences. Merges with existing preferences (partial update). Supports seniority levels, company stages, industries, locations, skills, and minimum compensation.
› "Set my preferences: Series A-B AI companies, senior roles, remote or SF, $180k+"
Saved Searches & Alerts
save_search
Save a job search and get a daily or weekly email when new matching jobs are posted. Filter by title, city/state, remote, company size, funding stage, and investors.
› "Watch for staff-level AI infra roles in SF and email me weekly"
list_saved_searches
List your saved searches with their filters, alert frequency, and when the last alert email went out.
› "What job alerts do I have set up?"
delete_saved_search
Delete a saved search by id and stop its email alerts.
› "Delete my old remote-fintech alert"
For Company Representatives
Free claim (sign in with your work Google account) unlocks the two profile tools below — no candidate subscription needed. Company Premium ($99/mo) additionally unlocks the full Employbl toolkit — every company, job, and funding intelligence tool on this page — for up to 10 teammates; teammates get a seat automatically by claiming with their work Google account. Objective data (funding, investors, headcount, verified roles) is maintained by Employbl and can never be company-edited.
get_my_company
Fetch your claimed company's profile status: last-30-day candidate view counts, profile completeness by section, published/draft state, and synced open roles.
› "How is our Employbl company profile doing?"
update_company_profile
Update your company's descriptive profile — tagline, product description, highlights, candidate FAQ, work model, hiring focus, tech stack, notable customers, perks, culture, careers page URL. Partial updates; changes go live on save.
› "Update our Employbl profile: we're hiring for ML infra and our stack is Rust + Kubernetes"
Personalized Recommendations
get_recommended_jobs
Get personalized job recommendations based on your profile and preferences. Returns jobs matching your target seniority, industries, company stages, locations, and minimum compensation. Optionally includes reasoning for each match.
› "Show me 10 recommended jobs with explanations"
get_recommended_companies
Get personalized company recommendations based on your preferences. Returns companies matching your preferred industries, stages, and locations, sorted by hiring activity. Optionally includes reasoning. Open-role counts reflect Employbl's synced coverage, not whether a company is hiring.
› "What companies match my preferences?"
rate_job
Give feedback on a recommended job so recommendations improve. Thumbs up ranks similar jobs higher; thumbs down hides it and downranks similar roles. Optional free-text reason plus a structured `reason_category` (location, not_remote, seniority, compensation, not_interested for down; role_fit, company, location_fit, compensation_fit for up).
› "Thumbs down that job — too senior for me"
dismiss_job
Hide a single job from your recommendations everywhere (web feed and MCP). Optionally include a reason and `reason_category` so future recommendations learn why.
› "Hide that last job from my recommendations"
hide_jobs_matching
Hide a whole class of jobs by rule — a location, a title keyword, or anything not remote. Rules persist across the web feed and MCP.
› "Stop showing me jobs in India"
Ask in plain English
“Find Series B AI companies in San Francisco with open senior engineering roles”
“Show me my profile and recommend 5 jobs that match my preferences”
“What companies raised funding recently, and which have open roles on Employbl?”
“Find companies similar to Stripe and summarize the top 3”
“Update my profile with my new job title and add my skills”
“Here's my resume [paste or attach] — build out my Employbl profile from it”
“Which Series A companies are in zip code 94133?”
“Find startups within 10 miles of me that just raised, and show their open roles”
“Compare Anthropic, OpenAI, and Mistral as employers”
“Watch for staff-level AI infra roles in SF and email me weekly”
The same data over plain HTTP
Every read endpoint below is served from the same indexes as the MCP tools — use it from scripts, notebooks, or any HTTP client. Base URL: https://www.employbl.com/api/v1. Machine-readable spec: OpenAPI 3.1.
Authentication: the same Bearer token as the MCP server, generated at Profile → MCP. Requires Employbl Premium or a Company Premium seat. Rate limits (60/min, 5,000/day) are shared with MCP tool calls on the same token; every response carries X-RateLimit-Remaining-Minute and X-RateLimit-Remaining-Day headers.
Responses use a { data, meta } envelope; errors use { error: { code, message } }.
Example response — GET /companies
{
"data": [
{
"name": "Anthropic",
"slug": "anthropic",
"city": "San Francisco",
"state": "CA",
"latest_round": { "name": "Series F", "date": "2026-03-04", "amount": 3500000000, "currency": "USD" },
"job_listing_count": 214,
"hiring": true,
"profile_url": "https://employbl.com/companies/anthropic"
}
],
"meta": { "total": 1287, "count": 1, "page": 1, "limit": 1 }
}GET/companies
Search 30,000+ American tech companies. Same index as the find_companies MCP tool.
| Param | Type | Description |
|---|---|---|
| query | string | Free-text company name search. |
| city | string | HQ city, exact match (case-insensitive). |
| state | string | Two-letter state code, e.g. CA. |
| zip | csv | Five-digit US zips, e.g. 94133,94111. Matches a company with an office in any of them — satellite offices count, not just the HQ. |
| near | string | Free-text US location (street address, City, ST, or a zip). Geocoded server-side, then matched by distance against every office. Combines with all other filters. |
| radius_miles | int | Search radius for near, 1-100. Defaults to 10. Ignored without near. |
| hiring | bool | true = only companies whose job listings Employbl has synced. Filters on Employbl's coverage, not on whether a company is hiring — Employbl tracks an ATS for roughly 9% of companies. |
| latest_round | csv | Funding stages, e.g. Series A,Series B. |
| sector | csv | Curated sector/subsector names (see employbl.com/industries). |
| tech_stack | csv | Technologies, matched against company-reported and job-derived stacks. |
| investors | csv | Investor names. |
| min_employees / max_employees | int | Company size bounds. |
| sort | enum | relevance (default), most_hiring, or recent_funding. |
| limit | int | Results per page, 1-50. Default 20. |
| page | int | Page number, starting at 1. |
curl -H "Authorization: Bearer $EMPLOYBL_TOKEN" \ "https://www.employbl.com/api/v1/companies?latest_round=Series%20A&zip=94133&limit=5"
GET/companies/{slug}
Full company profile: description, address, size, funding history, social links, and (when published) premium fields under premium_profile.
| Param | Type | Description |
|---|---|---|
| slug | path | Company slug, e.g. anthropic. |
curl -H "Authorization: Bearer $EMPLOYBL_TOKEN" \ "https://www.employbl.com/api/v1/companies/anthropic"
GET/companies/{slug}/similar
Curated similar companies for a given company — useful for exploring a market segment or finding alternative employers.
| Param | Type | Description |
|---|---|---|
| slug | path | Company slug to find peers for. |
curl -H "Authorization: Bearer $EMPLOYBL_TOKEN" \ "https://www.employbl.com/api/v1/companies/stripe/similar"
GET/jobs
Search 75,000+ active job listings. Same index as the search_jobs MCP tool.
| Param | Type | Description |
|---|---|---|
| query | string | Free-text title search. |
| city / state | string | Listing location filters (state is a two-letter code). |
| remote | bool | true = remote roles only. |
| level | string | Seniority, e.g. senior, staff. |
| min_salary | int | Minimum listed salary in USD. |
| posted_within_days | int | Only listings updated in the last N days. |
| funding_stage | csv | Company funding stages. |
| tech_stack / investors / industry / job_tags | csv | Company and listing attribute filters. |
| sort | enum | recency (default), relevance, recent_funding, most_raised, and more. |
| limit | int | Results per page, 1-50. Default 20. |
| page | int | Page number, starting at 1. |
curl -H "Authorization: Bearer $EMPLOYBL_TOKEN" \ "https://www.employbl.com/api/v1/jobs?remote=true&min_salary=180000&funding_stage=Series%20B&limit=5"
GET/jobs/{id}
Single job listing with the complete job description (not truncated) and company info.
| Param | Type | Description |
|---|---|---|
| id | path | Numeric listing id from the search results. |
curl -H "Authorization: Bearer $EMPLOYBL_TOKEN" \ "https://www.employbl.com/api/v1/jobs/12345"
GET/funding-rounds
Recent venture rounds across 75,000+ rounds. Defaults to the last 90 days. meta.data_current_through gives the newest round date in the dataset.
| Param | Type | Description |
|---|---|---|
| since | date | ISO date lower bound, e.g. 2026-01-01. |
| rounds | csv | Round names, e.g. Series A,Series B. |
| min_amount_usd | int | Minimum raise amount (USD rows only). |
| city / state | string | Company HQ filters. |
| hiring | bool | true = only companies whose job listings Employbl has synced. Recently funded companies are the least likely to be covered, so this hides many that are actively hiring. |
| sort | enum | recency (default) or amount. |
| limit | int | Results per page, 1-50. Default 20. |
| page | int | Page number, starting at 1. |
curl -H "Authorization: Bearer $EMPLOYBL_TOKEN" \ "https://www.employbl.com/api/v1/funding-rounds?rounds=Series%20B&min_amount_usd=10000000&limit=5"
Error codes
| Code | HTTP | Meaning |
|---|---|---|
| UNAUTHORIZED | 401 | Missing or invalid Bearer token. |
| PREMIUM_REQUIRED | 403 | Token's account has no active Premium subscription or company seat. |
| VALIDATION_ERROR | 400 | A query or path parameter failed validation; message says which. |
| NOT_FOUND | 404 | No entity with that slug/id. |
| RATE_LIMITED | 429 | Token exceeded 60/min or 5,000/day. Retry-After header included. |
| INTERNAL | 500 | Unexpected server error. |
Authentication and limits
Authentication: all MCP tools and REST API endpoints require a valid Employbl Premium access token, sent as a Authorization: Bearer <token> header. Tokens are permanent until revoked and should be kept secure.
Rate limiting: each token gets 60 requests per minute and 5,000 per day, shared across MCP and the REST API. REST responses include X-RateLimit-Remaining-* headers; exceeding a limit returns a clear error with retry-after guidance.
AI token usage: tools like summarize_company, personalize_search, and upload_profile_from_text consume AI tokens from your monthly allowance (or use your BYOK Anthropic key if configured). Each call uses approximately 1-6K tokens.
Questions and resources
Questions or issues? Email us at support@employbl.com
Feature requests: we're actively expanding the MCP and REST API surface. Have an idea for a new tool or endpoint? Let us know.
Model Context Protocol: learn more about MCP at modelcontextprotocol.io
What changed
find_companies now takes zip and near (radius around any geocoded US location), and both match satellite offices rather than only the HQ. find_companies_near_me gained latest_round, min_employees and max_employees, so "Series A companies near me" is a single call instead of an unanswerable oneget_recommended_companies hiring_only now defaults to false (it defaulted to true, silently limiting recommendations to the ~9% with a synced feed)rate_job and dismiss_job accept a structured reason_category alongside free text; dismiss_job gains an optional reason. Fixed update_preferences silently erasing hide-rulesrate_job, dismiss_job, hide_jobs_matching): rate jobs up/down, hide a single listing, or hide whole classes of jobs by location / keyword / non-remote. Feedback steers both the web "Jobs For You" feed and get_recommended_jobs, which now excludes hidden jobs and hide-rulesrecent_funding_rounds responses now end with "Funding data current through {date}" so staleness is visible; same marker in the REST meta.data_current_through fieldupdate_company_profile gains careers_url (rep-editable careers page link, rendered on the public profile)find_companies gains a sector filter over the curated industry taxonomy (17 sectors, 58 subsectors — see employbl.com/industries); legacy industry tags deprecatingfind_companies tech-stack filtering now matches technologies extracted from live job descriptions (2,400+ companies with job-derived stacks) in addition to company-reported stacksget_my_company, update_company_profile): claim-gated, no candidate subscription required, descriptive fields onlycompare_companies (side-by-side comparison of 2-5 companies) and saved-search tools (save_search, list_saved_searches, delete_saved_search) wired to the same email-alert system as the websitefind_companies_near_me (geo search over 29,000+ geocoded company HQs) and upload_profile_from_text (build your profile from a pasted resume or bio) toolsfind_similar_companies toolget_profile, update_profile, add_work_experience, add_skills), preference tools (get_preferences, update_preferences), and personalized recommendation tools (get_recommended_jobs, get_recommended_companies)