Public tool API
Send a JSON request to calculate a result. These endpoints use the same methods as the public tools and return units, assumptions and source details.
Requests and results
Send UTF-8 JSON with Content-Type: application/json; no account or API key is required. Calculations do not call an AI model, save a plan, send an invite or execute a task. A request can contain at most 32,768 bytes. Successful responses include the normalized input, method, units, assumptions and provenance.
Discover endpoints through the API catalog or read the OpenAPI contract. The catalog follows RFC 9727.
ai api cost calculator
Call POST /api/tools/ai-api-cost-calculator, or use the public tool for editable controls and JSON export.
curl https://operatornest.com/api/tools/ai-api-cost-calculator \
-H 'Content-Type: application/json' \
--data '{"inputTokens":10000,"cachedInputTokens":5000,"outputTokens":2000,"requestsPerDay":100,"requestsPerMonth":3000,"modelIds":["anthropic/claude-opus-5-5"]}'Token counts are whole numbers from 0 to 100,000,000 per request. Daily requests are 0–10,000,000; monthly requests are 0–100,000,000. Choose 1–20 unique model IDs from /api/models?subset=pricing, in providerId/id form, and keep cached input at or below total input. Optional batchModelIds requests published discounts for selected models; absent discounts produce a field error. Each estimate reports USD per request, day and month alongside the catalog snapshot date, with null for missing rates and non-token charges excluded.
Input schema
{
"type": "object",
"additionalProperties": false,
"properties": {
"inputTokens": {
"type": "integer",
"minimum": 0,
"maximum": 100000000,
"description": "Total input tokens per request, including cached input tokens.",
"examples": [
10000
]
},
"cachedInputTokens": {
"type": "integer",
"minimum": 0,
"maximum": 100000000,
"description": "Cached portion of inputTokens per request; must not exceed inputTokens. Use 0 without caching.",
"examples": [
5000
]
},
"outputTokens": {
"type": "integer",
"minimum": 0,
"maximum": 100000000,
"description": "Generated output tokens per request.",
"examples": [
2000
]
},
"requestsPerDay": {
"type": "integer",
"minimum": 0,
"maximum": 10000000,
"description": "Requests used to scale the daily estimate, independent of requestsPerMonth.",
"examples": [
100
]
},
"requestsPerMonth": {
"type": "integer",
"minimum": 0,
"maximum": 100000000,
"description": "Requests used to scale the monthly estimate; not inferred from the daily count.",
"examples": [
3000
]
},
"modelIds": {
"type": "array",
"minItems": 1,
"maxItems": 20,
"uniqueItems": true,
"description": "Unique providerId/id values from the MCP pricing catalog. Unknown or unavailable IDs fail validation.",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"pattern": "\\S",
"description": "Model ID accepted by the MCP pricing catalog."
}
},
"batchModelIds": {
"type": "array",
"minItems": 0,
"maxItems": 20,
"uniqueItems": true,
"items": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"pattern": "\\S",
"description": "Selected model ID with a published batch discount."
},
"description": "Optional subset of modelIds to price with published batch discounts. Omission or [] uses standard rates; IDs without a published discount are rejected.",
"examples": [
[]
]
}
},
"required": [
"inputTokens",
"cachedInputTokens",
"outputTokens",
"requestsPerDay",
"requestsPerMonth",
"modelIds"
]
}meeting time zone planner
Call POST /api/tools/meeting-time-zone-planner, or use the public tool for editable controls and JSON export.
curl https://operatornest.com/api/tools/meeting-time-zone-planner \
-H 'Content-Type: application/json' \
--data '{"date":"2026-10-05","people":[{"name":"Sam","zone":"America/Los_Angeles"},{"name":"Priya","zone":"America/New_York"}]}'Choose 2–8 people, names of 1–80 characters and valid IANA time zones. Using the first person’s zone for the date, the tool checks real half-hour instants, including repeated or skipped hours at daylight saving changes, against 09:00–17:00 local workdays. It ranks 30-minute overlaps by distance from 13:00 at each slot’s midpoint. UTC start times and local labels accompany the best three slots and the full grid. Holidays and personal calendar availability are outside this calculation.
Input schema
{
"type": "object",
"additionalProperties": false,
"properties": {
"date": {
"type": "string",
"format": "date",
"minLength": 10,
"maxLength": 10,
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Meeting date in the first person’s local time zone, from 2000-01-01 to 2100-12-31.",
"examples": [
"2026-10-05"
]
},
"people": {
"type": "array",
"minItems": 2,
"maxItems": 8,
"description": "Participants in display order. The first person determines the local date; all must fit a full half-hour inside 09:00–17:00.",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"name": {
"type": "string",
"minLength": 1,
"maxLength": 80,
"pattern": "\\S",
"description": "Participant label used in the returned local-time display.",
"examples": [
"Sam"
]
},
"zone": {
"type": "string",
"minLength": 1,
"maxLength": 100,
"pattern": "\\S",
"description": "IANA time zone supported by Intl.DateTimeFormat.",
"examples": [
"America/New_York",
"Asia/Kolkata"
]
}
},
"required": [
"name",
"zone"
]
}
}
},
"required": [
"date",
"people"
]
}recurring task planner
Call POST /api/tools/recurring-task-planner, or use the public tool for editable controls and JSON export.
curl https://operatornest.com/api/tools/recurring-task-planner \
-H 'Content-Type: application/json' \
--data '{"startDate":"2026-10-05","tasks":[{"title":"Investor update","frequency":"weekly","day":"MO","monthday":1,"minutes":35,"time":"09:00","owner":"delegate"}]}'Choose 0–20 tasks with titles of 1–80 characters, 1–1,440 minutes per run, and a weekly, biweekly or monthly frequency. Supply a weekday code, a day of month from 1–28, a valid HH:mm time, and an owner decision of delegate, keep or decide. The start date anchors every two weeks. Monthly hours use 52/12 weekly runs, 26/12 biweekly runs and one monthly run. The response includes recurrence rules and a folded calendar file. Calendar times float in the importing calendar’s local time zone, so no UTC or daylight saving offset is imposed.
Input schema
{
"type": "object",
"additionalProperties": false,
"properties": {
"startDate": {
"type": "string",
"format": "date",
"minLength": 10,
"maxLength": 10,
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Earliest date for the first occurrence of each task, from 2000-01-01 to 2100-12-31.",
"examples": [
"2026-10-05"
]
},
"tasks": {
"type": "array",
"minItems": 0,
"maxItems": 20,
"description": "Tasks to include in the estimate and calendar. [] returns zero hours and a calendar with no events.",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"title": {
"type": "string",
"minLength": 1,
"maxLength": 80,
"pattern": "\\S",
"description": "Task label used as the calendar event summary.",
"examples": [
"Investor update"
]
},
"frequency": {
"type": "string",
"enum": [
"weekly",
"biweekly",
"monthly"
],
"description": "Repeat every week, every two weeks from the first matching weekday, or every month."
},
"day": {
"type": "string",
"enum": [
"MO",
"TU",
"WE",
"TH",
"FR",
"SA",
"SU"
],
"description": "Weekday for weekly/biweekly tasks. Required but ignored for monthly tasks.",
"examples": [
"MO"
]
},
"monthday": {
"type": "integer",
"minimum": 1,
"maximum": 28,
"description": "Day of month for monthly tasks, limited to dates present in every month. Required but ignored for weekly/biweekly tasks.",
"examples": [
1
]
},
"minutes": {
"type": "integer",
"minimum": 1,
"maximum": 1440,
"description": "Estimated minutes per run; used for event duration and monthly hours.",
"examples": [
35
]
},
"time": {
"type": "string",
"minLength": 5,
"maxLength": 5,
"pattern": "^([01][0-9]|2[0-3]):[0-5][0-9]$",
"description": "24-hour HH:mm start time, floating in the importing calendar’s local time zone.",
"examples": [
"09:00"
]
},
"owner": {
"type": "string",
"enum": [
"delegate",
"keep",
"decide"
],
"description": "Planning label: delegate to an operator, keep for yourself, or decide later. Included in the calendar note; does not assign or execute work."
}
},
"required": [
"title",
"frequency",
"day",
"monthday",
"minutes",
"time",
"owner"
]
}
}
},
"required": [
"startDate",
"tasks"
]
}Dates and errors
Use real calendar dates from 2000-01-01 through 2100-12-31 and only fields in the input schema. Error responses use {"error":{"code":"invalid_input","message":"Cached tokens cannot exceed input tokens.","field":"cachedInputTokens"}}. Correct the named field and retry with your original values.
| Status | Meaning |
|---|---|
| 400 | Malformed UTF-8 JSON |
| 413 | Body over 32,768 bytes |
| 415 | Send application/json |
| 422 | Input outside the documented bounds |
| 405 | Use POST for calculations |
| 500 | Calculation unavailable; retry later |
Model catalog
GET /api/models returns a read-only snapshot with its source and update date, with optional filters provider, q, type=decision|default|all and subset=pricing. Filters are case insensitive, with an empty model list for no matches and status 400 with an error string for an invalid type or subset. Responses have an ETag and a one-hour shared cache policy; send If-None-Match to receive a bodyless 304 when the snapshot matches.
Browser tool access
The three public pages register these calculations through WebMCP’s imperative API when the browser supports it. A tool call updates the visible inputs and results, while regular controls work without that browser feature. Browser support is experimental.
Hand off your first task tonight.
Tell us your email and what you'd hand off first. We'll send your access details and help you set up your operator.