airoles
MCP setup

Use AIroles from inside your AI tool.

MCP (Model Context Protocol) is the standard that lets your AI assistant safely call services like AIroles. Connect Claude, Cursor, or any MCP-compatible client once, and it can search jobs and apply on your behalf — or post, promote, and manage roles if you're hiring.

Tool-by-tool setup.

Pick your AI client. The token, endpoint, and tools are the same — only the config file location changes.

Endpoint
https://mcp.airoles.io/mcp
Auth headerSign in to generate →
Authorization: Bearer <token>
OpenAI

ChatGPT

Custom connector
  1. 1
    Open Connectors

    In ChatGPT, go to Settings → Connectors → Create (requires Plus/Pro/Business).

  2. 2
    Add the server

    Paste the URL below, choose Bearer auth, and drop YOUR_TOKEN from /account.

  3. 3
    Enable in chat

    Turn the airoles connector on in your chat and ask it to search or apply.

ChatGPT → Settings → Connectors
URL:    https://mcp.airoles.io/mcp
Auth:   Bearer YOUR_TOKEN
Name:   airoles

Replace YOUR_TOKEN with the token shown once at /account when you generate it.

“Use airoles to find remote AI product roles paying over $150k.”
Available tools
  • search_jobsSearch the AIroles board with filters (family, seniority, remote, language, free-text).
  • get_jobFetch full details for a specific job by ID.
  • apply_to_jobRecord an apply intent and get back the company's apply link, email, or WhatsApp target.
  • post_jobStub for posting via MCP; v1 requires company auth, use the web dashboard at /company/post.

Troubleshooting.

The most common snags, and how to fix them.

My AI says it can't connect.
Double-check the token has no extra spaces, the URL is exactly https://mcp.airoles.io/mcp, and fully restart your AI app after editing the config.
I lost my token.
Tokens are shown only once. Rotate it from /account — the old one stops working immediately, then paste the new one into your config.
Can I share my token with a teammate?
No. Tokens are personal and tied to your candidate profile. Sharing one mixes your apply history with someone else's.

Ready to let your AI use AIroles?

Generate a token