CVin.Bio Developer Resources & API Documentation

CVin.Bio Machine-Readable Specifications

• GET /openapi.json — CVin.Bio OpenAPI 3.1 specification.
• GET /.well-known/mcp.json — CVin.Bio MCP server manifest.
• POST /mcp — CVin.Bio MCP server over Streamable HTTP (JSON-RPC 2.0: initialize, tools/list, tools/call).
• GET /.well-known/oauth-authorization-server — RFC 8414 Authorization Server Metadata.
• GET /.well-known/oauth-protected-resource — RFC 9728 Protected Resource Metadata.
• GET /llms.txt · /llms-full.txt — CVin.Bio LLMs directory and context index.
• GET /agent.txt — CVin.Bio agent instructions and when-to-use guidance.
• GET /sitemap.xml — sitemap; /rss.xml — RSS feed.
• CVin.Bio on Smithery Registry
• CVin.Bio on mcp.so Registry

CVin.Bio REST API Endpoints

• GET /api/jobs?page=1&limit=20&q=&type=&loc=remote

  Paginated feed of curated tech jobs. Returns { jobs[], total, page, limit, hasMore }. Optional Supabase bearer auth personalizes match scores.

  operationId: listJobs

• GET /api/jobs/{id}

  Full detail for one public job, including sanitized description HTML when published.

  operationId: getJob

• GET /api/news?limit=10

  Recent aggregated items from tier-1 tech news sources (Hacker News, TechCrunch, The Verge, Ars Technica…).

  operationId: listTechNews

• GET /api/profile/{username}

  Flattened public candidate profile for a cvin.bio username slug.

  operationId: getPublicProfile

• POST /api/contact

  Submit a support/partnership message. JSON body: { email, purpose, message }. Rate limited to 5/hour per IP.

  operationId: submitContactMessage

CVin.Bio MCP Tools

The same data is available to AI agents via the Model Context Protocol at https://cvin.bio/mcp. Point any MCP client (Claude, ChatGPT, Cursor) at the Streamable HTTP endpoint — tool listing is public.

• search_jobs — Search curated tech jobs by keyword, company, or location.
• get_job — Fetch one job listing with full description and apply link.
• platform_stats — Live counts of jobs, companies, and public profiles on CVin.Bio.

CVin.Bio Webhooks & Event Notifications

CVin.Bio provides real-time job updates and profile indexing events via polling feeds and webhooks:

• GET /rss.xml — RSS 2.0 feed of new technology jobs and platform news
• GET /api/jobs?sort=latest — polling feed for new job listings
• POST /api/contact — partner webhook registration requests (email hi@cvin.bio)

CVin.Bio Rate Limits

API responses carry standard rate-limit headers: RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset (RFC 9331 draft) plus the legacy X-RateLimit-* set. Read endpoints allow 300 requests/minute per IP; contact submissions are limited to 5/hour per IP. On HTTP 429, honor the Retry-After header before retrying.

CVin.Bio Errors

All API errors return JSON — never HTML pages — shaped as { error, code?, hint? }. Unknown /api/* paths return a JSON 404 pointing back to this document and the OpenAPI spec.

API Versioning & Deprecation Policy

CVin.Bio APIs use URL-path major versioning (current stable: /api/* alias of /v1/api/*). When an endpoint or version is scheduled for deprecation, CVin.Bio guarantees a minimum 180-day notice period and signals deprecation on every affected response via standard HTTP headers:

• Deprecation: @<unix-timestamp> — RFC 9261 deprecation header
• Sunset: <HTTP-date> — RFC 8594 sunset date header
• Link: <url>; rel="deprecation" — link to migration documentation

Breaking changes are never introduced within a major version. Non-breaking additive changes may be introduced at any time.

Developer Support

Questions about the API or developer integrations? Email hi@cvin.bio or use the contact page.