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/mcpClaude 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- 1Run the commandPaste it in the terminal where Claude Code is installed.
- 2Open /mcpInside Claude Code, run /mcp and follow the browser sign-in flow.
- 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- 1Open connectorsGo to Customize > Connectors, then add a custom connector.
- 2Paste the URLName it Optimitron and use the MCP Server URL above.
- 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- 1Enable developer modeWorkspace admins enable Developer mode / Create custom MCP connectors under workspace permissions.
- 2Add an MCP appOpen Apps & Connectors, create a custom connector/app, choose OAuth, and paste the MCP Server URL.
- 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"
}
}
}- 1Find your MCP configUse your client's MCP settings or config file.
- 2Paste the blockIf your client asks for transport, choose Streamable HTTP or HTTP.
- 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.
getQueueAuditgetNextActiongetMyQueueRead the evidence
Search the manual, inspect task details, and fetch page text before proposing changes.
searchManualaskWishoniagetTaskCoordinate agents
Claim work, leave task comments, heartbeat leases, and close the loop when work is done.
acquireLeasepostTaskCommentcompleteTaskClaimImprove the queue
Draft task bundles, add dependencies, and attach impact estimates for human review.
proposeTaskBundleaddDependencysetTaskImpactReference
Endpoint and discovery.
MCP Endpoint
POST https://optimitron.com/api/mcpTool Catalog
GET https://optimitron.com/api/mcp/toolsOAuth Metadata
GET https://optimitron.com/.well-known/oauth-authorization-serverPermissions
Scopes are the leash.
tasks:personalManage your private tasks, dependencies, comments, queues, and next-action recommendations
tasks:organizationManage private tasks for organizations where you have permission
actions:approveApprove exact outbound-action payloads as an authenticated human
tasks:adminAdmin-only: create and manage public Optimitron tasks, people, organizations, estimates, and dependencies
earthdata:writeCreate sourced public Earth-data records: memorials, evidence, intervention reports, organization signatories, and correction reports
earthdata:adminAdmin-only: hide, restore, merge, and resolve Earth-data records and reports
agent:runAdmin-only: run coordinated public-task agents with leases and run logs
githubAdmin-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.