Earth Optimization API

Optimize Earth from your own app or website.

Connect your survey, dFDA site, field tool, or civic app to Optimitron's shared work graph: OAuth, people, organizations, tasks, referrals, votes, and expected-value coordination.

OpenAPI Contract

/openapi.json

Open OpenAPI Install MCP

Who Uses It

One to-do list beats five hundred heroic duplicates.

Optimitron is useful when an app needs shared identity, people, organizations, tasks, and outcome tracking. The task engine ranks work by dollar-equivalent expected value, effort, cash cost, probability, dependencies, and health or income impact.

Survey sites

Run a calmer survey or pledge page, then send the verified vote, referral, and follow-up task back to Optimitron.

Disease communities

Let a dFDA site collect patient priorities, treatment reports, or organization support without creating another isolated people database.

Research funders

Publish bounties, assignments, or requests for evidence, then rank the next action by expected value instead of whoever shouted last.

Civic and nonprofit tools

Coordinate outreach, volunteers, expert review, and institutional commitments against the same shared task and organization record.

OAuth

Sign in once. Write to the same work graph.

Optimitron exposes OAuth authorization code with PKCE, dynamic client registration, rotating refresh tokens, and token revocation. The same scopes work for REST endpoints and the MCP server.

1Register a public clientSend redirect URIs to dynamic client registration. Optimitron returns a client_id; public clients do not get a secret.
2Start authorizationRedirect the user to the authorization endpoint with PKCE, state, redirect_uri, and the scopes your app needs.
3Exchange and refreshTrade the authorization code for a Bearer token. Refresh tokens rotate, and revoke is available when the app disconnects.

Metadata

Let OAuth clients discover the authorization, token, registration, and revocation endpoints.

GET /.well-known/oauth-authorization-server

Register

Create a public client for browser, mobile, and field apps.

POST /api/mcp/oauth/register

{
  "client_name": "Treaty Field App",
  "redirect_uris": [
    "https://field-app.example/oauth/callback"
  ],
  "grant_types": [
    "authorization_code",
    "refresh_token"
  ],
  "scope": "tasks:personal earthdata:write"
}

Authorize and token

Use PKCE for the browser redirect, then exchange the code on your own server or backend.

GET /api/mcp/oauth/authorize
POST /api/mcp/oauth/token
POST /api/mcp/oauth/revoke

REST API

The useful parts are open first.

These are the open endpoints for embedding a survey, creating tasks for people, collecting votes, and keeping organization data attached to the same shared record.

Tasks

Create task assignments, list open work, claim work, complete claims, and keep comments with the task instead of in a lost chat thread.

GET /api/tasksPOST /api/tasksPATCH /api/tasks/{id}POST /api/tasks/{id}/complete

Referrals

Create referral invitations, attach them to tasks, and track whether a human copied, sent, declined, or finished the ask.

GET /api/referral-invitationsPOST /api/referral-invitations

Votes

Let another site collect a referendum, survey, or treaty vote while writing the result into the same verified record Optimitron uses.

POST /api/referendums/{slug}/vote

People and organizations

Search assignable people, create organizations, and update profiles so one contact or institution does not get rediscovered from scratch every Tuesday.

GET /api/people/searchGET /api/organizationsPOST /api/organizationsPATCH /api/organizations/{id}

Example

Create a task for a human.

A survey or outreach app can ask for a person, create the task, and then show whether that person answered, voted, completed the work, or needs another nudge.

POST /api/tasks

{
  "title": "Ask Dr. Example to vote on the 1% Treaty",
  "description": "Send the treaty vote link and answer any obvious question.",
  "isPublic": false,
  "assigneePersonInvite": {
    "email": "doctor@example.org",
    "firstName": "Ada",
    "lastName": "Example"
  },
  "contactTemplate": "Please vote on the 1% Treaty and send it to two people who can help."
}

Permissions

Ask for the smallest scope that works.

tasks:personal

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

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)

Agents use the same authorization.

MCP clients can discover tools, add impact estimates, and call the task graph with the same OAuth scopes used by REST clients.

GET /api/mcp/tools
POST /api/mcp

MCP Setup

Machines can read the contract.

Point API clients, SDK generators, or documentation tooling at the OpenAPI document and stop guessing from source files.

GET /openapi.json

Open JSON

Booting Earth Optimization System

Thank you for your patience. Your civilization is very important to us.

One to-do list beats five hundred heroic duplicates.

Survey sites

Run a calmer survey or pledge page, then send the verified vote, referral, and follow-up task back to Optimitron.

Disease communities

Let a dFDA site collect patient priorities, treatment reports, or organization support without creating another isolated people database.

Research funders

Publish bounties, assignments, or requests for evidence, then rank the next action by expected value instead of whoever shouted last.

Civic and nonprofit tools

Coordinate outreach, volunteers, expert review, and institutional commitments against the same shared task and organization record.

Optimitron exposes OAuth authorization code with PKCE, dynamic client registration, rotating refresh tokens, and token revocation. The same scopes work for REST endpoints and the MCP server.

1Register a public clientSend redirect URIs to dynamic client registration. Optimitron returns a client_id; public clients do not get a secret.

2Start authorizationRedirect the user to the authorization endpoint with PKCE, state, redirect_uri, and the scopes your app needs.

3Exchange and refreshTrade the authorization code for a Bearer token. Refresh tokens rotate, and revoke is available when the app disconnects.

POST /api/mcp/oauth/register { "client_name": "Treaty Field App", "redirect_uris": [ "https://field-app.example/oauth/callback" ], "grant_types": [ "authorization_code", "refresh_token" ], "scope": "tasks:personal earthdata:write" }

The useful parts are open first.

These are the open endpoints for embedding a survey, creating tasks for people, collecting votes, and keeping organization data attached to the same shared record.

Tasks

Create task assignments, list open work, claim work, complete claims, and keep comments with the task instead of in a lost chat thread.

GET /api/tasksPOST /api/tasksPATCH /api/tasks/{id}POST /api/tasks/{id}/complete

Referrals

Create referral invitations, attach them to tasks, and track whether a human copied, sent, declined, or finished the ask.

GET /api/referral-invitationsPOST /api/referral-invitations

Votes

Let another site collect a referendum, survey, or treaty vote while writing the result into the same verified record Optimitron uses.

POST /api/referendums/{slug}/vote

People and organizations

Search assignable people, create organizations, and update profiles so one contact or institution does not get rediscovered from scratch every Tuesday.

GET /api/people/searchGET /api/organizationsPOST /api/organizationsPATCH /api/organizations/{id}

Create a task for a human.

A survey or outreach app can ask for a person, create the task, and then show whether that person answered, voted, completed the work, or needs another nudge.

POST /api/tasks

{
  "title": "Ask Dr. Example to vote on the 1% Treaty",
  "description": "Send the treaty vote link and answer any obvious question.",
  "isPublic": false,
  "assigneePersonInvite": {
    "email": "doctor@example.org",
    "firstName": "Ada",
    "lastName": "Example"
  },
  "contactTemplate": "Please vote on the 1% Treaty and send it to two people who can help."
}

Ask for the smallest scope that works.

tasks:personal

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

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)