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
- Your assistant opens a CentaurHire sign-in.
- You approve the scopes in Settings → Assistants.
- 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
| Tool | When to use it | Scope | What it changes |
|---|---|---|---|
marketplace.jobs.list_open | Use 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.read | Reads only. Nothing is published or paid. |
marketplace.jobs.create_draft | Use 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.write | Creates a draft only. A human publishes. |
marketplace.jobs.update_draft | Use 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.write | Creates a draft only. A human publishes. |
marketplace.proposals.create_draft | Use 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.write | Creates a draft only. A human publishes. |
marketplace.proposals.submit_for_review | Use 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.request | Creates a draft only. A human publishes. |
marketplace.proposals.list_pending | Use 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.status | Reads only. Nothing is published or paid. |
marketplace.connections.status | Use 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.read | Reads 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.
| Tool | When to use it |
|---|---|
experiments.public.list | Use when you want public experiment playbooks. Read only. |
experiments.public.search | Use when you want public experiment playbooks that match a title or goal. Read only. |
experiments.public.get | Use 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.