MCP tools

The 8 tools your agent gets when it connects to https://api.startup.jobs/mcp. All read-only, all free.

search_jobs

Search jobs

Search live startup job listings, newest first. Returns compact job summaries; use get_job for the full description. The free tier covers the last 14 days of listings; full access unlocks the archive and posted_before.

q string: Keywords matched against job titles and company names max length 200
role string: Role slug from list_roles (e.g. software-engineer)
country string: Two-letter ISO country code (e.g. US, NL)
workplace_type string: on-site remote hybrid
employment_type string: full-time part-time internship contractor
company string: Company slug, as returned by get_company or search results
posted_after string: Only jobs published after this ISO 8601 date or timestamp
posted_before string: Only jobs published before this ISO 8601 date or timestamp (full access only)
limit integer: Results per page (default 20) min 1 · max 50
cursor string: next_cursor value from the previous page

get_job

Get job

Fetch a single job listing by id, including the full description. Share the job's startup.jobs URL with the user so they can apply there.

id integer · required: Job id from search_jobs results

get_company

Get company

Fetch a company profile by slug, including its startup.jobs URL and live listing count.

slug string · required: Company slug, as returned in job payloads

get_company_jobs

Get company jobs

List all live job listings for one company (no recency window), newest first. Returns compact summaries; use get_job for full descriptions.

slug string · required: Company slug
limit integer: Results per page (default 20) min 1 · max 50
cursor string: next_cursor value from the previous page

list_roles

List roles

List the role taxonomy (title, slug, parent_slug). Use slugs as the role filter in search_jobs, job_trends, and salary_benchmarks.

No parameters.

list_countries

List countries

List countries with jobs (name, ISO country code). Use the codes as the country filter in search_jobs, job_trends, and salary_benchmarks.

No parameters.

job_trends

Job trends

Job posting volume trends on startup.jobs, optionally filtered by role and/or country. The free tier returns a 12-month summary with year-over-year change; full access unlocks the monthly time series (up to 36 months).

role string: Role slug from list_roles (specific roles only, not top-level categories)
country string: Two-letter ISO country code
months integer: How many months of history (default 12, full access only) min 1 · max 36

salary_benchmarks

Salary benchmarks

Salary benchmarks (yearly, USD) computed from startup.jobs listings that disclose compensation, optionally filtered by role and/or country. The free tier returns an aggregate over the last 12 months; full access unlocks the monthly time series and company-level benchmarks.

role string: Role slug from list_roles (specific roles only, not top-level categories)
country string: Two-letter ISO country code
company string: Company slug (full access only)
months integer: How many months of history (default 12, full access only) min 1 · max 36

Same data over plain HTTP? The REST API has matching endpoints and an OpenAPI spec. Need the archive, structured salaries or longer series? Ask for full access.