Skip to content
codercops
Get started

AI assistants

Use codercops from your AI assistant.

codercops has an MCP server. MCP (Model Context Protocol) is the open standard that assistants such as Claude and ChatGPT use to connect to other services. Add it once and you can search builders and jobs from a chat, or sign in so the assistant can read your own account. It only gets the permissions you allow.

Two addresses

What your assistant can do

There are two addresses. Use the first if you only want to look around. Use the second to work with your own account. It includes everything the first one has, so you only ever need one of them.

No sign-in

Public search

https://api.codercops.com/mcp

Anyone can use it. It sees what the public site shows: published jobs, public builder profiles, company pages and prices.

  • search_builders

    Find builders by skill. Can be limited to builders codercops verified, or to those available now.

  • get_builder

    One builder's public profile: bio, skills, rate, projects, work history and education.

  • search_jobs

    Open jobs, filtered by category and tech stack.

  • get_job

    One job in full: description, requirements, budget and company.

  • get_company

    A hiring company's public page and its open roles.

  • get_pricing

    What is free, what costs credits, the credit packs, and the managed recruiting terms.

Signs in to your account

Your account

https://api.codercops.com/mcp/account

Signs in to your codercops account and includes the six public tools. With the permissions you allow, it can also read:

  • my_profile

    Your account and builder profile, whether it is verified, and what is still missing before it can go public.

  • list_my_jobs

    The job posts you created, and where each one is in review.

  • list_threads

    Your conversations, newest first, with unread ones marked.

  • get_thread

    The latest messages in one conversation. Reading them here does not mark them as read.

  • credits_balance

    Your credit balance, and where to buy more.

Signing in needs a codercops account with a confirmed email address.

Things to ask

  • Find verified React developers on codercops who are available now.
  • Show me open AI and ML jobs on codercops that use Python.
  • What is still missing from my codercops profile?
  • Do I have unread messages on codercops? Summarise them.

Connect

Connect your assistant

The steps below use the account address. For public search only, use https://api.codercops.com/mcp instead and skip the sign-in. When you sign in, codercops opens its own approval screen in your browser, where you choose the permissions.

Claude

On claude.ai and the Claude desktop app, on every plan. The Free plan allows one custom connector.

  1. Go to Customize > Connectors.
  2. Select Add, then Add custom connector.
  3. Name it codercops, paste the account address, and click Continue.
  4. Keep the sign-in settings Claude marks as Detected, then click Add.
  5. Click Connect. Sign in to codercops, tick the permissions you want, and approve.
  6. In a chat, open the + menu, choose Connectors, and turn codercops on.

On Team and Enterprise plans, an Owner adds the connector under Organization settings > Connectors. Each member then finds it under Customize > Connectors and clicks Connect to sign in with their own codercops account. Anthropic's guide to custom connectors

ChatGPT

On ChatGPT on the web, for Business, Enterprise and Edu workspaces. On Business, only admins and owners can add one. Pro accounts can connect with read access. The mobile apps can't add a custom server.

  1. Go to Plugins.
  2. Select the plus button, then Add custom MCP server.
  3. Name it codercops. Under Connection, paste the account address.
  4. Set authentication to OAuth.
  5. Read the risk warning, tick I understand and want to continue, and select Create as a plugin.
  6. Install the plugin. When codercops asks, sign in, tick the permissions you want, and approve.
  7. In a new chat, type @ and pick codercops.

Some workspaces still show an older Apps screen instead of Plugins. OpenAI's guide to custom MCP servers covers both.

Claude Code

Add the server from your terminal:

claude mcp add --transport http codercops https://api.codercops.com/mcp/account

Then run /mcp inside Claude Code, choose codercops, and sign in in the browser window that opens.

The Claude Code MCP docs cover scopes and removing a server.

Permissions

You choose what it can do

When you connect, codercops shows an approval screen with eight permissions. You tick the ones you want, and the assistant gets those and nothing else. The public tools need none of them. Each permission below is shown with the screen's own wording and the tools it opens.

Look

  • See your codercops profile

    profile:read

    Tools: my_profile

  • See your job posts

    jobs:read

    Tools: list_my_jobs

  • Read your messages

    messages:read

    Tools: list_threads, get_thread

  • See your credit balance

    credits:read

    Tools: credits_balance

Change

These appear on the approval screen now, but they do nothing until actions are switched on.

  • Change your codercops profile

    profile:write

    Tools: preview_profile_changes, update_my_profile

  • Post job posts for your company

    jobs:write

    Tools: preview_job_post, post_job

  • Apply to jobs as you

    applications:write

    Tools: preview_application, apply_to_job

  • Send messages as you

    messages:write

    Tools: preview_message, send_message

Actions

Coming later

Apply, message, post and edit

Actions are not switched on yet. When they are, an assistant with the matching permission will be able to do four things for you. Each one takes two steps, and nothing happens until the second.

  1. Preview

    The assistant calls the preview tool. codercops checks the request and returns exactly what would happen, such as the message a company would see. Nothing changes.

  2. Act, if you say yes

    The assistant shows you the preview. Only if you agree does it call the acting tool, which carries out that preview and nothing else. It runs once, and a preview expires after ten minutes.

  • Apply to a job

    preview_applicationthenapply_to_job

    Permission
    Apply to jobs as you
    Limit
    10 applications a day

    The company sees your message exactly as written, with your public profile.

  • Send a message

    preview_messagethensend_message

    Permission
    Send messages as you
    Limit
    20 messages an hour

    A reply in one of your existing conversations, sent as you.

  • Post a job

    preview_job_postthenpost_job

    Permission
    Post job posts for your company
    Limit
    3 job posts a day

    A job posted this way always goes to codercops review before anyone can see it.

  • Edit your profile

    preview_profile_changesthenupdate_my_profile

    Permission
    Change your codercops profile
    Limit
    20 profile edits a day

    An assistant can't change your username, your photos or your visibility settings.

The limits are per person, counted across every assistant you connect.

Disconnect

Take access back

  • In codercops, go to Settings, then Connected apps, at app.codercops.com/settings/connected-apps. Every assistant you have connected is listed there. Choose Disconnect next to one and it can no longer reach your account.
  • Changing your codercops password disconnects every assistant at once.
  • Removing codercops from an assistant's own settings stops that assistant from using it. Disconnecting in codercops is what ends its access to your account, so do that too.

FAQ

Questions about assistants

No. You sign in on codercops' own page, not inside the assistant. The assistant gets access that only covers the permissions you ticked, and you can take it back in Settings, under Connected apps, at any time.

Not yet. Right now an assistant can only read. When actions are switched on, every change will be previewed first, and nothing will happen until you say yes.

Not for public search: https://api.codercops.com/mcp works without signing in. Reading your own profile, job posts, messages or credit balance needs a codercops account with a confirmed email address.

Any assistant that can connect to a remote MCP server over HTTP. This page has the steps for Claude, ChatGPT and Claude Code. For any other assistant, give it one of the two addresses and follow its own instructions for adding an MCP server.

Help

Help, privacy and terms

Create a codercops accountLog in