Skip to content

Connect an assistant

An assistant can look up open jobs and prepare drafts on CentaurHire. It cannot publish a listing, accept work, or move money. A person does those steps.

Not certified by any AI provider.

What the server does

The server speaks MCP, a standard way for an assistant to call a small set of tools. The public address is https://centaurhire.io/api/mcp. A call with no login gets 401, including the first handshake.

How sign-in works

  1. Your assistant opens a CentaurHire sign-in.
  2. You approve the scopes in Settings → Assistants.
  3. You can revoke that connection on the same page.

Scopes are the permissions you grant, such as reading open jobs or writing a draft. The assistant cannot grant itself a new one.

Tools

ToolWhen to use itScopeWhat it changes
marketplace.jobs.list_openUse when the user wants to see open work requests. Returns open jobs and a next cursor. Does not write a draft; a human reviews and publishes. Requires connection scope jobs.read.jobs.readReads only. Nothing is published or paid.
marketplace.jobs.create_draftUse when the user wants to start a private job post. Returns jobPostId and missingForPublish. Send a title plus an outcome, deliverables, or acceptance criteria. Creates a draft only; a human reviews and publishes. Requires connection scope drafts.write.drafts.writeCreates a draft only. A human publishes.
marketplace.jobs.update_draftUse when the user wants to change their private job draft. Returns draftRevision, or conflict if expectedRevision is stale. Creates a draft only; a human reviews and publishes. Requires connection scope drafts.write.drafts.writeCreates a draft only. A human publishes.
marketplace.proposals.create_draftUse when the user wants a proposal a person can review, such as job.publish. Returns the draft proposal. It does not create a System or job post. Creates a draft only; a human reviews and publishes. Requires connection scope drafts.write.drafts.writeCreates a draft only. A human publishes.
marketplace.proposals.submit_for_reviewUse when the user wants a draft proposal in the approval inbox. Returns the pending proposal. Creates a draft only; a human reviews and publishes. Requires connection scope approval.request.approval.requestCreates a draft only. A human publishes.
marketplace.proposals.list_pendingUse when the user wants the status of their proposals. Returns draft and pending proposals. Does not write a draft; a human reviews and publishes. Requires connection scope action.status.action.statusReads only. Nothing is published or paid.
marketplace.connections.statusUse when the user wants to know which assistant is connected. Returns grant scopes. tokenScopes are not the marketplace authority. Does not write a draft; a human reviews and publishes. Requires connection scope marketplace.read.marketplace.readReads only. Nothing is published or paid.

Machine-readable copies: server card and tool catalog.

Public experiment playbooks

A second MCP server reads experiment playbooks that their owners set to Public. Its address is https://centaurhire.io/api/mcp/public. It needs no sign-in and does not ask for one. It only reads. It cannot save, change, or share a playbook. Private and unlisted playbooks are never returned.

ToolWhen to use it
experiments.public.listUse when you want public experiment playbooks. Read only.
experiments.public.searchUse when you want public experiment playbooks that match a title or goal. Read only.
experiments.public.getUse when you want one public experiment playbook. Read only.

Each playbook follows the experiment file format v0.1 (JSON Schema). Lists and searches return at most 20 playbooks per call. Each result links to its file as Markdown and JSON.

Things you can type

  • List the open jobs on CentaurHire.
  • Draft a job post for a weekly research digest. Do not publish it.
  • Update that draft and show me what is still missing.
  • Draft a proposal asking me to publish the job. Leave it for me to approve.
  • Show the status of my assistant connection.

Safety

  • Draft tools save a private draft. They do not publish it.
  • A proposal waits for a person. Nothing is paid from the assistant.
  • Open jobs, assistant access, and draft writing can each be switched off. When a switch is off, that action stops.

Clients

Cursor — Experimental, not certified

The repo does not ship a certified Cursor guide. A remote MCP entry looks like this:

{
  "mcpServers": {
    "centaurhire": {
      "url": "https://centaurhire.io/api/mcp"
    }
  }
}

Claude — Experimental, not certified

Setup steps coming soon.

ChatGPT — Not available yet (needs developer mode, pilot)

Setup steps coming soon.

Grok — Partial, tested Oct 2026

A production connect was tested on 1 October 2026 by adding the server URL https://centaurhire.io/api/mcp. That test is not a certification. The assistant opens a CentaurHire sign-in for the account owner.