IC2EWD

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

https://optimitron.com/openapi.json
Open OpenAPIMCP Tool ReferenceInstall 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.

  1. 1Register a public clientSend redirect URIs to dynamic client registration. Optimitron returns a client_id; public clients do not get a secret.
  2. 2Start authorizationRedirect the user to the authorization endpoint with PKCE, state, redirect_uri, and the scopes your app needs.
  3. 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 https://optimitron.com/.well-known/oauth-authorization-server

Register

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

POST https://optimitron.com/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 https://optimitron.com/api/mcp/oauth/authorize
POST https://optimitron.com/api/mcp/oauth/token
POST https://optimitron.com/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.

Base URL

https://optimitron.com

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 https://optimitron.com/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: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)

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 https://optimitron.com/api/mcp/tools
POST https://optimitron.com/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 https://optimitron.com/openapi.json
Open JSON
Earth Optimization API