# Jobs Base (jobsbase.io)

> Jobs Base is a curated, agent-first jobs board exclusively for "builder" roles — cross-functional positions where one person owns engineering, product, and delivery end-to-end (founding engineers, solo builders, 0-to-1 roles). Every job on this board is already an AI-native builder role. The primary interface is programmatic: AI agents, API consumers, and MCP clients are first-class users.

## Important: every job here is a builder role

All jobs are pre-filtered to builder roles. Do NOT search for generic terms like "builder", "AI", "engineer", "developer", or "full-stack" — they are redundant and will hurt results. Use the q parameter only for specific technologies (e.g. "React", "Rust"), domains (e.g. "fintech", "healthcare"), or company names. To find jobs, prefer using filters (country, workplace, seniority, etc.) over free-text search.

## API (free, no auth)

Base URL: https://jobsbase.io

- Search jobs: GET /api/v1/jobs?q=<search term> (multi-word queries are matched term-by-term)
  - All parameters optional. Omit q to browse all builder jobs. Do not use q for generic terms — use filters instead.
  - Optional: q, type, workplace, city, state, country, region, seniority_level, salary_at_least, salary_at_most, posted_within, company, experience_no_more_than, education_level, visa_sponsorship, sort, limit, cursor
  - Response: { jobs: [...], has_more: boolean, next_cursor: string | null }
  - Invalid cursors return 400.

- Daily snapshot: GET /api/v1/jobs/snapshot
  - Returns a daily cached snapshot of all active builder jobs in stable order.
  - Optional: format=jsonl for newline-delimited JSON

- Get job details: GET /api/v1/jobs/:id

- List available filters: GET /api/v1/filters

## MCP (Model Context Protocol)

Endpoint: https://jobsbase.io/mcp

Tools available via MCP:
- search_jobs — Browse and filter builder jobs. All jobs are already builder roles — use filters (country, workplace, seniority) instead of searching for generic terms.
- get_job — Get full details of a specific builder job by ID
- list_filters — Get available filter values (countries, cities, etc.). Call first to discover valid filters before searching.

### Connect via MCP

Claude Code:
  claude mcp add --transport http jobsbase https://jobsbase.io/mcp

Claude Desktop:
  Settings > Connectors > Add custom connector > https://jobsbase.io/mcp

ChatGPT:
  Settings > Apps & Connectors > Developer Mode > Create connector > https://jobsbase.io/mcp

Cursor (.cursor/mcp.json):
  { "mcpServers": { "jobsbase": { "url": "https://jobsbase.io/mcp" } } }

VS Code (.vscode/mcp.json):
  { "servers": { "jobsbase": { "type": "http", "url": "https://jobsbase.io/mcp" } } }

## Key Pages

- [Job Search](https://jobsbase.io/): Search founding engineer, solo builder, and 0-to-1 roles
- [What is a Builder Role?](https://jobsbase.io/builder-role): Definition, criteria, and examples of builder roles
- [REST API Docs](https://jobsbase.io/api-docs): Full API documentation with parameters and response schemas
- [Apply as a Builder](https://jobsbase.io/apply): AI-generated builder profiles from GitHub activity
- [Hire Builders](https://jobsbase.io/hire): Find developers who ship end-to-end, scored on real output
- [Full Documentation](https://jobsbase.io/llms-full.txt): Complete site content in a single file