# Bordfeed > API-first job feed platform: curated, AI-enriched job data over a REST API. ## Docs - [OpenAPI spec](https://bordfeed.com/api/openapi.json) - [Pricing JSON](https://bordfeed.com/pricing.json) - [Pricing](https://bordfeed.com/pricing) - [Quick Start](https://bordfeed.com/docs.md): Fill a niche job board or a job newsletter with fresh, filtered jobs, without searching for them by hand. - [Webhooks](https://bordfeed.com/docs/webhooks.md): Post new jobs from your feed straight to your job board, hourly, daily or weekly. - [Email digest](https://bordfeed.com/docs/email-digest.md): Get your job newsletter section written and delivered on schedule, with a short intro and one blurb per job. - [Export](https://bordfeed.com/docs/export.md): Download every job a feed matches in one request, as CSV, JSON, HTML or Markdown. - [MCP](https://bordfeed.com/docs/mcp.md): Use Bordfeed from Claude, ChatGPT, Grok, Codex, Cursor or VS Code. Search jobs, create and manage feeds, poll and export them, and check your balance from your AI. - [Grok](https://bordfeed.com/docs/grok.md): Connect Grok to Bordfeed to search jobs, manage feeds and export them from a Grok chat or from Grok Build. - [Errors](https://bordfeed.com/docs/errors.md): Every error code the Bordfeed API returns, what it means and what to do next. - [API Reference](https://bordfeed.com/docs/api.md): Every endpoint, with its summary and description, from the OpenAPI spec. - [Open data: hiring signals](https://bordfeed.com/signals): a citable dataset of companies actively hiring, with methodology and citation formats. - [Open data: salary ranges](https://bordfeed.com/salaries): a citable dataset of median posted pay by role and country. - [Open data: job market trends](https://bordfeed.com/trends): weekly new and closed job counts, with role movers and citation formats. ## Auth for agents - [auth.md](https://bordfeed.com/auth.md): how an AI agent gets access. MCP clients sign in with OAuth. REST callers use an API key a person creates in the dashboard. Agents can sign up with an email code (POST /api/agent/register then /api/agent/verify); see auth.md. ## Pricing - Pro: $79/month or $758/year, 25,000 jobs included, unlimited feeds, every delivery channel - Max: $299/month or $2,870/year, 200,000 jobs included, unlimited feeds, every delivery channel - Ultra: $999/month or $9,590/year, 1,000,000 jobs included, unlimited feeds, every delivery channel - Pay as you go: $0.01 per job, $20 in free credit once, no card to start. A full job costs 1 credit, charged once per organization. Getting it again is free, even after it changes or closes. Lists, search, retries and empty pages are free. Top up $10, $50, $100 or $1,000 at a time. Credits never expire and are not refunded. Unlimited feeds, every delivery channel. - Check balance: GET /api/v1/billing/balance or the X-Bordfeed-Balance-Jobs response header. Once the balance runs out, a page with unpaid jobs that the balance cannot cover returns HTTP 402 with error.code insufficient_credits and a topup_url. That link opens Stripe Checkout for this workspace for about an hour, with no Bordfeed sign-in. It is pay as you go only. Plans stay in the dashboard. ## MCP - Server: https://bordfeed.com/api/mcp (Streamable HTTP). Setup guide: https://bordfeed.com/docs/mcp - Auth: OAuth (the user signs in to Bordfeed and picks an organization; dynamic client registration and client ID metadata documents are supported), or a Bordfeed API key as Authorization: Bearer or x-api-key: . - Claude Code: run `claude mcp add --transport http --scope user bordfeed https://bordfeed.com/api/mcp`, then /mcp to sign in. - Claude.ai & Desktop: Customize → Connectors → Add custom connector, paste the URL, then Connect and sign in. - ChatGPT: Plugins → + → Add custom MCP server, paste https://bordfeed.com/api/mcp/chatgpt with OAuth, then sign in (Business, Enterprise or Edu workspaces). - Grok: grok.com/connectors → New Connector → Custom, paste the URL, then sign in. - Codex CLI: run `codex mcp add bordfeed --url https://bordfeed.com/api/mcp`, then `codex mcp login bordfeed`. - Grok Build: run `grok mcp add --transport http bordfeed https://bordfeed.com/api/mcp`, then sign in from /mcps. - Cursor: add `{"mcpServers":{"bordfeed":{"url":"https://bordfeed.com/api/mcp"}}}` to ~/.cursor/mcp.json, then sign in when asked. - VS Code: run `code --add-mcp '{"name":"bordfeed","type":"http","url":"https://bordfeed.com/api/mcp"}'`, then sign in from Copilot agent mode. - Plugin (instead of the Claude Code or Cursor setup above, not both; adds a bordfeed skill): Claude Code: run `claude plugin marketplace add craftled/bordfeed-plugin` then `claude plugin install bordfeed@bordfeed`; Cursor 2.5+: `/add-plugin bordfeed@https://github.com/craftled/bordfeed-plugin` in a new Agent chat. Remove a manually added bordfeed server first. Repo: https://github.com/craftled/bordfeed-plugin ## MCP tools - search: Search active job listings by keywords. Free. - fetch: Fetch one job listing by id as {id, title, text, url, metadata}. Billable per returned job. - search_jobs: Search active job listings with filters. Free. - get_job: Get one active job by id or slug with a plain-text description (capped at 6,000 chars), description_truncated and description_length fields. Billable per returned job. - get_jobs: Open up to 25 jobs by id or slug in one call, each with a plain-text description (capped at 6,000 chars, with description_truncated and description_length) and apply link, in request order. Billable per returned job. - list_feeds: List this workspace's saved job feeds (id, name, filters, enabled, delivery_mode, last_poll_at). Free. - poll_feed: Get a saved feed's jobs newest first. Billable per returned job. - export_jobs: Export a saved feed's jobs newest first as JSON or CSV. Billable per returned job. - create_feed: Create a saved job feed in this workspace. Free. - get_feed: Get one saved feed's name, filters, enabled state, delivery mode and template for free. Free. - list_templates: List the feed templates (id, name, description, filters) for free. Free. - update_feed: Change a saved feed's name, filters or enabled state. Free. - delete_feed: Permanently delete a saved feed; this cannot be undone, so confirm with the user first. Free. - get_balance: Returns the caller's prepaid Bordfeed balance in jobs, plan, price per job and top-up URL. Free. - get_pricing: Returns Bordfeed's public pricing (plans and pay as you go per-job price). Free. - create_topup_link: Returns a link that opens Stripe Checkout for prepaid Bordfeed credits ($0.01 per job, top-ups of $10, $50, $100 or $1,000). Free.