Optimitron MCP

Give your AI the live task graph.

Connect Claude, ChatGPT, or another MCP client to Optimitron so the agent can choose useful work, read the evidence, coordinate through task comments, and stop hallucinating from old chat history.

MCP Server URL

https://optimitron.com/api/mcp

Claude Code

One command, then /mcp.

Use this when the agent is working in a repo and needs the live queue, manual, task comments, and coordination tools.

claude mcp add --transport http optimitron https://optimitron.com/api/mcp
  1. 1Run the commandPaste it in the terminal where Claude Code is installed.
  2. 2Open /mcpInside Claude Code, run /mcp and follow the browser sign-in flow.
  3. 3Authorize OptimitronApprove the requested scopes. The connector uses OAuth and PKCE; no client secret goes in your config.

Claude

Add a custom connector.

Use this for Claude on the web, desktop, mobile, Cowork, Team, or Enterprise.

https://optimitron.com/api/mcp
  1. 1Open connectorsGo to Customize > Connectors, then add a custom connector.
  2. 2Paste the URLName it Optimitron and use the MCP Server URL above.
  3. 3ConnectSign in and authorize the connector. Claude should discover the OAuth endpoints automatically.

ChatGPT

Create a custom MCP app.

Use this when your ChatGPT plan and workspace settings allow custom MCP apps.

https://optimitron.com/api/mcp
  1. 1Enable developer modeWorkspace admins enable Developer mode / Create custom MCP connectors under workspace permissions.
  2. 2Add an MCP appOpen Apps & Connectors, create a custom connector/app, choose OAuth, and paste the MCP Server URL.
  3. 3AuthorizeSign in to Optimitron. Use regular chat; agent mode does not reach custom MCP apps, and some deep research surfaces only show search/fetch tools.

Other MCP Clients

Paste the JSON if your client wants config.

Cursor, Windsurf, Cline, Zed, and similar clients usually want a small MCP server block.

{
  "mcpServers": {
    "optimitron": {
      "url": "https://optimitron.com/api/mcp"
    }
  }
}
  1. 1Find your MCP configUse your client's MCP settings or config file.
  2. 2Paste the blockIf your client asks for transport, choose Streamable HTTP or HTTP.
  3. 3Complete OAuthOpen the authorization URL your client gives you and approve the scopes.

What agents get

Less guessing. More useful work.

Pick work

Audit the queue, compare expected value, and ask for the next useful action.

getQueueAuditgetNextActiongetMyQueue

Read the evidence

Search the manual, inspect task details, and fetch page text before proposing changes.

searchManualaskWishoniagetTask

Coordinate agents

Claim work, leave task comments, heartbeat leases, and close the loop when work is done.

acquireLeasepostTaskCommentcompleteTaskClaim

Improve the queue

Draft task bundles, add dependencies, and attach impact estimates for human review.

proposeTaskBundleaddDependencysetTaskImpact
Full Tool Reference

Reference

Endpoint and discovery.

MCP Endpoint

POST https://optimitron.com/api/mcp

Tool Catalog

GET https://optimitron.com/api/mcp/tools

OAuth Metadata

GET https://optimitron.com/.well-known/oauth-authorization-server

Permissions

Scopes are the leash.

tasks:personal

Manage your private tasks, dependencies, comments, queues, and next-action recommendations

tasks:organization

Manage private tasks for organizations where you have permission

actions:approve

Approve exact outbound-action payloads as an authenticated human

tasks:admin

Admin-only: create and manage public Optimitron tasks, people, organizations, estimates, and dependencies

earthdata:write

Create sourced public Earth-data records: memorials, evidence, intervention reports, organization signatories, and correction reports

earthdata:admin

Admin-only: hide, restore, merge, and resolve Earth-data records and reports

agent:run

Admin-only: run coordinated public-task agents with leases and run logs

github

Admin-only: access the configured GitHub repos via the server-side PAT (search code, read files, list directories, generic API passthrough)

Want the long version?

The repo doc explains the personal task engine, expected-value fields, task triggers, and local stdio setup.

Read Docs
Optimitron MCP