AI SENSE Free Public Tools MCP
An official MCP server provided by AI SENSE AS that exposes its free public REST API endpoints as tools. It supports agent workflows, audio data transfer (encode/decode), semantic search, one-time secrets, agent handoff, and agent run capabilities without requiring authentication.
Endpoint and access
No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.
https://aisenseapi.com/mcpWhat its tools do
79 tools, grouped by the hints the server advertises. Hints are self-declared, not verified behavior.
Read-only (39)
get_current_timegenerate_uuidread_temporary_dataread_webhook_captureread_human_approvalread_heartbeatcreate_lease_namespaceread_agent_inboxread_agent_queueread_agent_queue_jobread_dns_nameencode_dataencode_audiodecode_audiohash_dataverify_hashgenerate_randomtime_formatsconvert_timestamplist_timezoneslookup_networkvalidate_emailvalidate_valueslugify_textjwt_tokencreate_qr_coderead_qr_codecrypto_wallethtml_markdown_convertdecidesimulate_failureread_webhook_scheduleservice_healthread_stored_filequery_semantic_searchread_semantic_searchread_one_time_secret_receiptread_agent_handoffread_agent_run
Can change data (40)
shorten_urlstore_temporary_datacreate_webhook_capturecreate_human_approvalcreate_agent_wakecreate_heartbeatping_heartbeatacquire_leaserenew_leaserelease_leasecomplete_leasecreate_agent_inboxcreate_agent_queueenqueue_agent_queue_jobclaim_agent_queue_joback_agent_queue_jobrelease_agent_queue_jobrenew_agent_queue_jobcreate_dns_nameupdate_dns_namedelete_dns_namehtml_to_pdfjson_csv_convertjson_checkmatch_tablesprocess_imageschedule_webhookcancel_webhook_schedulestore_filecreate_semantic_searchadd_semantic_search_notesdelete_semantic_search_notecreate_one_time_secretreveal_one_time_secretburn_one_time_secretcreate_agent_handoffadvance_agent_handoffcreate_agent_runcomplete_agent_run_stepcancel_agent_run
Checks and signals
Each line is separate evidence, not a trust score.
- Passed Endpoint answered the live check ·
- Passed Official MCP Registry namespace is tied to aisenseapi.com ·
- Passed Endpoint is on the registry namespace domain ·
- Warning Advertises resources/templates/list but does not implement it
- Availability 1 of 1 checks passed in 30 days
What you can do with it
- Transfer data via audio encoding and decoding
- Perform semantic search across short notes
- Manage agent workflows and state handoffs
- Store and reveal one-time encrypted secrets
Source and maintenance
- Maintenance checked
Protocol and capabilities
- Server
- AI SENSE Free Public Tools 1.18.0
- MCP protocol negotiated in check
- 2025-11-25
- Tools
- 79 advertised
- Resources
- 3 advertised
- Resource templates
- Not advertised
- Prompts
- Not advertised
{
"tools": {
"listChanged": false
},
"resources": {
"subscribe": false,
"listChanged": false
}
}Server-provided instructions
Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.
Tools
79 advertised
get_current_time — Get current time
Get the true current date and time, as an ISO 8601 string and a Unix timestamp, for any timezone. Use this whenever the actual present moment matters - stamping a record, computing an age or a deadline, deciding whether something has expired - because a language model has no clock and will otherwise guess a date from its training data. No API key, no account and no sign up. The timezone parameter accepts an IANA name or a fixed UTC offset and defaults to UTC.
{
"type": "object",
"properties": {
"timezone": {
"type": "string",
"default": "UTC",
"description": "IANA timezone or UTC offset, such as Europe/Oslo or +02:00."
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"datetime",
"timestamp",
"timezone"
],
"properties": {
"datetime": {
"type": "string"
},
"timezone": {
"type": "string"
},
"timestamp": {
"type": "integer"
}
}
}{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true
}generate_uuid — Generate UUID
Generate one random RFC 4122 version 4 UUID. Use it when you need an identifier that will not collide with anything else - an idempotency key, a correlation id across systems, a filename - rather than inventing a string yourself, which is not random and tends to repeat across runs. Takes no parameters and returns a single lowercase hyphenated UUID. No API key, no account and no sign up.
{
"type": "object",
"properties": {},
"additionalProperties": false
}{
"type": "object",
"required": [
"uuid"
],
"properties": {
"uuid": {
"type": "string",
"format": "uuid"
}
}
}{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": false
}shorten_url — Shorten URL
Turn a long URL into a short 307.fi link that redirects to it. Use it when a URL has to be typed, read aloud, pasted into a message with a length limit, or put in front of a person. No API key, no account and no sign up. The link stops working 24 hours after creation, so do not use it for anything that must survive longer than a day; it is for handoffs inside a task, not for publishing.
{
"type": "object",
"required": [
"long_url"
],
"properties": {
"long_url": {
"type": "string",
"format": "uri",
"maxLength": 4096,
"description": "HTTP or HTTPS URL to shorten."
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"short_url",
"expire_timestamp"
],
"properties": {
"short_url": {
"type": "string",
"format": "uri"
},
"expire_timestamp": {
"type": "integer"
}
}
}{
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}store_temporary_data — Store temporary data
Put any JSON value somewhere another process can fetch it, and get back a storage_id plus a public read_url. Use it to hand a result to a different agent, a script, a webhook receiver or a later run, when there is no shared filesystem and no database between you. No API key, no account and no sign up. Anyone holding the URL can read it, so never store secrets, credentials or personal data. The value disappears 24 hours after it is written. Read it back with read_temporary_data, passing the storage_id. The answer also carries sha256_hash, the digest of the stored bytes, and bytes, their length, so a receiver can tell it got what you sent. The same object over REST calls the link storage_url and serves it with that digest as its ETag. max_downloads, 1 to 100, removes the value after that many reads; the answer then carries downloads_max and downloads_left, and a spent storage_id answers that the object is gone.
{
"type": "object",
"required": [
"data"
],
"properties": {
"data": {
"description": "The JSON value to store. Any type: object, array, string, number, boolean or null. Readable by anyone with the URL, so no secrets."
},
"max_downloads": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Optional. How many times the value may be read before it is removed, 1 to 100. Without it the value lives 24 hours."
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"storage_id",
"read_url",
"sha256_hash",
"bytes",
"expire_timestamp"
],
"properties": {
"bytes": {
"type": "integer"
},
"read_url": {
"type": "string",
"format": "uri"
},
"storage_id": {
"type": "string",
"format": "uuid"
},
"sha256_hash": {
"type": "string"
},
"downloads_max": {
"type": "integer"
},
"downloads_left": {
"type": "integer"
},
"expire_timestamp": {
"type": "integer"
}
}
}{
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}read_temporary_data — Read temporary data
Fetch back a JSON value that store_temporary_data saved earlier, in this session or in another one. Returns the value exactly as it was stored. Fails if the id is unknown or if the 24 hour lifetime has already passed, so treat a failure as expired or never written rather than as a temporary fault worth retrying. sha256_hash is the digest of the stored bytes and bytes their length, the same values store_temporary_data reported. A value stored with max_downloads answers downloads_left, how many reads remain, and is gone once they are taken. No API key, no account and no sign up.
{
"type": "object",
"required": [
"storage_id"
],
"properties": {
"storage_id": {
"type": "string",
"format": "uuid",
"description": "The UUID that store_temporary_data returned."
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"storage_id",
"data",
"sha256_hash",
"bytes",
"expire_timestamp"
],
"properties": {
"data": {},
"bytes": {
"type": "integer"
},
"storage_id": {
"type": "string",
"format": "uuid"
},
"sha256_hash": {
"type": "string"
},
"downloads_left": {
"type": "integer"
},
"expire_timestamp": {
"type": "integer"
}
}
}{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true
}create_webhook_capture — Create webhook capture
Create a throwaway URL that records the next HTTP request anyone sends to it, headers and body included. Use it to see what a webhook provider, a form or a third party service actually transmits, instead of trusting their documentation, and to prove that an integration fired at all. No API key, no account and no sign up. The pending capture is stored before this call returns. Optional notify_url receives one small completion signal with a result URL after the first request arrives. The callback does not contain the captured request. Whatever is sent to update_url becomes publicly readable, so do not use it for secrets, credentials or personal data.
{
"type": "object",
"properties": {
"notify_url": {
"type": "string",
"format": "uri",
"maxLength": 2048,
"description": "Optional public HTTP or HTTPS callback with a host name, not an IP address. It receives one small signal after capture."
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"ok",
"capture_id",
"status",
"update_url",
"read_url",
"wait_url",
"expire_timestamp",
"expire_datetime"
],
"properties": {
"ok": {
"type": "boolean"
},
"status": {
"type": "string",
"const": "pending"
},
"read_url": {
"type": "string",
"format": "uri"
},
"wait_url": {
"type": "string",
"format": "uri"
},
"capture_id": {
"type": "string",
"format": "uuid"
},
"update_url": {
"type": "string",
"format": "uri"
},
"expire_datetime": {
"type": "string"
},
"expire_timestamp": {
"type": "integer"
}
},
"additionalProperties": false
}{
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}read_webhook_capture — Read webhook capture
Check whether anything has been sent to a capture URL yet, and read it. The status field is pending or captured. Pending is the ordinary answer before the sender fires and is not a failure. Set wait_seconds from 1 to 25 to wait efficiently for the first request. The call returns early when the capture changes. Zero reads the current state immediately. Unknown and expired IDs fail. No API key, no account and no sign up.
{
"type": "object",
"required": [
"capture_id"
],
"properties": {
"capture_id": {
"type": "string",
"format": "uuid",
"description": "The UUID that create_webhook_capture returned."
},
"wait_seconds": {
"type": "integer",
"default": 0,
"maximum": 25,
"minimum": 0,
"description": "Wait up to this many seconds for a request. Zero returns immediately."
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"ok",
"capture_id",
"status",
"created_at_timestamp",
"created_at_datetime",
"captured_at_timestamp",
"captured_at_datetime",
"expire_timestamp",
"expire_datetime",
"request",
"waited_seconds",
"wait_reason"
],
"properties": {
"ok": {
"type": "boolean"
},
"status": {
"enum": [
"pending",
"captured"
],
"type": "string"
},
"request": {
"type": [
"object",
"null"
]
},
"capture_id": {
"type": "string",
"format": "uuid"
},
"wait_reason": {
"enum": [
"terminal",
"changed",
"timeout",
"immediate",
"unavailable",
"stalled"
],
"type": "string"
},
"waited_seconds": {
"type": "number",
"minimum": 0
},
"expire_datetime": {
"type": "string"
},
"expire_timestamp": {
"type": "integer"
},
"created_at_datetime": {
"type": "string"
},
"captured_at_datetime": {
"type": [
"string",
"null"
]
},
"created_at_timestamp": {
"type": "integer"
},
"captured_at_timestamp": {
"type": [
"integer",
"null"
]
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true
}create_human_approval — Request human approval
Put a decision in front of one to twenty people. Use one respondent for a normal approval, or several when every invited person should answer through a separate bearer form link. Group results contain counts, a tally and anonymous numbered responses. Optional notify_url receives one small signal after the final answer. It does not contain the answers. Forms expire after 24 hours. No API key, account or login is required.
{
"type": "object",
"required": [
"title"
],
"properties": {
"title": {
"type": "string",
"maxLength": 200,
"description": "Required. The question shown to the person, in their language. Make it answerable on its own, since they see no conversation history."
},
"options": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100
},
"default": [
"Approve",
"Reject"
],
"maxItems": 10,
"minItems": 2,
"description": "Optional. The buttons offered, 2 to 10 of them. Defaults to Approve and Reject. Use your own labels when the choice is not a yes or no, for example Ship today, Ship Monday, Cancel."
},
"allow_note": {
"type": "boolean",
"default": true,
"description": "Optional. Whether the person may add a free text comment alongside their choice. Defaults to true."
},
"notify_url": {
"type": "string",
"format": "uri",
"maxLength": 2048,
"description": "Optional public HTTP or HTTPS callback with a host name, not an IP address, after the final answer."
},
"description": {
"type": "string",
"maxLength": 2000,
"description": "Optional supporting detail below the question: what changes, what it costs, what happens if they decline."
},
"respondents": {
"type": "integer",
"default": 1,
"maximum": 20,
"minimum": 1,
"description": "Number of separate form links. Each link can answer once."
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"ok",
"action_id",
"status",
"result_url",
"wait_url",
"expire_timestamp",
"expire_datetime"
],
"properties": {
"ok": {
"type": "boolean"
},
"tally": {
"type": "object"
},
"status": {
"type": "string",
"const": "pending"
},
"answered": {
"type": "integer",
"minimum": 0
},
"form_url": {
"type": "string",
"format": "uri"
},
"wait_url": {
"type": "string",
"format": "uri"
},
"action_id": {
"type": "string",
"format": "uuid"
},
"form_urls": {
"type": "array",
"items": {
"type": "string",
"format": "uri"
},
"maxItems": 20,
"minItems": 2
},
"responses": {
"type": "array"
},
"result_url": {
"type": "string",
"format": "uri"
},
"respondents": {
"type": "integer",
"maximum": 20,
"minimum": 2
},
"expire_datetime": {
"type": "string"
},
"expire_timestamp": {
"type": "integer"
}
},
"additionalProperties": false
}{
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}read_human_approval — Read human approval
Check whether the person has answered a form from create_human_approval, and read the answer. For a group, partial means at least one person has answered and answered means all form links are complete. The group view contains counts, a tally and anonymous respondent numbers, never form tokens or notification settings. Set wait_seconds from 1 to 25 to wait for a change, or zero to read immediately. No API key, account or sign up is required.
{
"type": "object",
"required": [
"action_id"
],
"properties": {
"action_id": {
"type": "string",
"format": "uuid",
"description": "The UUID that create_human_approval returned."
},
"wait_seconds": {
"type": "integer",
"default": 0,
"maximum": 25,
"minimum": 0,
"description": "Wait up to this many seconds for a new answer. Zero returns immediately."
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"ok",
"action_id",
"status",
"created_at_timestamp",
"created_at_datetime",
"expire_timestamp",
"expire_datetime",
"answered_at_timestamp",
"answered_at_datetime",
"response",
"waited_seconds",
"wait_reason"
],
"properties": {
"ok": {
"type": "boolean"
},
"tally": {
"type": "object"
},
"status": {
"enum": [
"pending",
"partial",
"answered"
],
"type": "string"
},
"answered": {
"type": "integer",
"maximum": 20,
"minimum": 0
},
"response": {
"type": [
"object",
"null"
]
},
"action_id": {
"type": "string",
"format": "uuid"
},
"responses": {
"type": "array",
"items": {
"type": "object",
"required": [
"respondent",
"answered_at_timestamp",
"answered_at_datetime",
"response"
],
"properties": {
"response": {
"type": "object"
},
"respondent": {
"type": "integer",
"maximum": 20,
"minimum": 1
},
"answered_at_datetime": {
"type": [
"string",
"null"
]
},
"answered_at_timestamp": {
"type": "integer"
}
},
"additionalProperties": false
}
},
"respondents": {
"type": "integer",
"maximum": 20,
"minimum": 2
},
"wait_reason": {
"enum": [
"terminal",
"changed",
"timeout",
"immediate",
"unavailable",
"stalled"
],
"type": "string"
},
"waited_seconds": {
"type": "number",
"minimum": 0
},
"expire_datetime": {
"type": "string"
},
"expire_timestamp": {
"type": "integer"
},
"created_at_datetime": {
"type": "string"
},
"answered_at_datetime": {
"type": [
"string",
"null"
]
},
"created_at_timestamp": {
"type": "integer"
},
"answered_at_timestamp": {
"type": [
"integer",
"null"
]
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true
}create_agent_wake — Wait for an event
Create a durable MCP task that completes when a webhook arrives, a person answers a form or a chosen time is reached. Use it when an agent must pause and continue after an outside event without holding one HTTP request open. The task lasts from 60 seconds to 24 hours. Webhook bodies and human answers are readable by anyone holding the task URL, so do not send secrets, credentials or personal data.
{
"type": "object",
"required": [
"event_type"
],
"properties": {
"title": {
"type": "string",
"maxLength": 200,
"description": "For human events. The question shown on the form."
},
"options": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100
},
"default": [
"Approve",
"Reject"
],
"maxItems": 10,
"minItems": 2,
"description": "For human events. The choices on the form."
},
"wake_at": {
"type": "integer",
"description": "For time events. Unix timestamp to wake at."
},
"allow_note": {
"type": "boolean",
"default": true,
"description": "For human events. Allow an optional note."
},
"event_type": {
"enum": [
"webhook",
"human",
"time"
],
"type": "string",
"description": "The event that completes the task."
},
"description": {
"type": "string",
"maxLength": 2000,
"description": "For human events. Supporting detail shown below the title."
},
"delay_seconds": {
"type": "integer",
"minimum": 1,
"description": "For time events. Wake this many seconds from now."
},
"timeout_seconds": {
"type": "integer",
"default": 86400,
"maximum": 86400,
"minimum": 60,
"description": "Maximum task lifetime in seconds."
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"task_id",
"event_type",
"completed_at_timestamp",
"completed_at_datetime"
],
"properties": {
"task_id": {
"type": "string",
"format": "uuid"
},
"event_type": {
"type": "string"
},
"completed_at_datetime": {
"type": "string"
},
"completed_at_timestamp": {
"type": "integer"
}
},
"additionalProperties": true
}{
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}create_heartbeat — Create heartbeat
Create a deadline monitor for a job, device or agent that should keep checking in. Call ping_heartbeat before the expected interval plus grace period ends. One missed deadline calls a public HTTP or HTTPS webhook or wakes an active Agent Wake webhook task. The monitor lasts at most 24 hours from creation, and pings cannot extend that limit. The returned heartbeat ID and URLs are bearer secrets. No authentication is required.
{
"type": "object",
"required": [
"expect_every_seconds",
"grace_seconds",
"on_miss"
],
"properties": {
"on_miss": {
"type": "object",
"oneOf": [
{
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"payload": {
"description": "Optional JSON body, at most 32768 encoded bytes."
}
},
"additionalProperties": false
},
{
"required": [
"wake_task_id"
],
"properties": {
"wake_task_id": {
"type": "string",
"format": "uuid"
}
},
"additionalProperties": false
}
],
"description": "Exactly one miss target. Use url for a public HTTP or HTTPS webhook with a host name, not an IP address, on port 80 or 443, or wake_task_id for an active Agent Wake webhook task."
},
"grace_seconds": {
"type": "integer",
"maximum": 86400,
"minimum": 0,
"description": "Extra time after the expected check-in before the miss action fires. The expected interval plus grace must not exceed 86400 seconds."
},
"expect_every_seconds": {
"type": "integer",
"maximum": 86400,
"minimum": 60,
"description": "Expected time between check-ins, from 60 seconds to 24 hours."
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"ok",
"heartbeat_id",
"status",
"expect_every_seconds",
"grace_seconds",
"created_at_timestamp",
"created_at_datetime",
"expires_at_timestamp",
"expires_at_datetime",
"last_ping_at_timestamp",
"last_ping_at_datetime",
"next_expected_at_timestamp",
"next_expected_at_datetime",
"miss_due_at_timestamp",
"miss_due_at_datetime",
"ping_count",
"misses",
"late",
"on_miss",
"ping_url",
"status_url"
],
"properties": {
"ok": {
"type": "boolean"
},
"late": {
"type": "boolean"
},
"misses": {
"type": "integer"
},
"status": {
"enum": [
"armed",
"missed",
"fired",
"expired"
],
"type": "string"
},
"on_miss": {
"type": "object",
"required": [
"type"
],
"properties": {
"type": {
"enum": [
"webhook",
"agent_wake"
],
"type": "string"
}
},
"additionalProperties": false
},
"delivery": {
"type": "object"
},
"ping_url": {
"type": "string",
"format": "uri"
},
"ping_count": {
"type": "integer"
},
"status_url": {
"type": "string",
"format": "uri"
},
"heartbeat_id": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
"grace_seconds": {
"type": "integer"
},
"missed_at_datetime": {
"type": "string"
},
"created_at_datetime": {
"type": "string"
},
"expires_at_datetime": {
"type": "string"
},
"missed_at_timestamp": {
"type": "integer"
},
"created_at_timestamp": {
"type": "integer"
},
"expect_every_seconds": {
"type": "integer"
},
"expires_at_timestamp": {
"type": "integer"
},
"miss_due_at_datetime": {
"type": "string"
},
"terminal_at_datetime": {
"type": "string"
},
"last_ping_at_datetime": {
"type": "string"
},
"miss_due_at_timestamp": {
"type": "integer"
},
"terminal_at_timestamp": {
"type": "integer"
},
"last_ping_at_timestamp": {
"type": "integer"
},
"next_expected_at_datetime": {
"type": "string"
},
"next_expected_at_timestamp": {
"type": "integer"
}
},
"additionalProperties": true
}{
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}read_heartbeat — Read heartbeat
Read one heartbeat immediately. Use it to inspect whether the monitor is armed, missed, fired or expired, whether it is running late, and its next deadline. This does not wait for a state change. The heartbeat ID is a 256-bit bearer secret. No authentication is required.
{
"type": "object",
"required": [
"heartbeat_id"
],
"properties": {
"heartbeat_id": {
"type": "string",
"pattern": "^[a-f0-9]{64}$",
"description": "The secret heartbeat ID returned by create_heartbeat."
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"ok",
"heartbeat_id",
"status",
"expect_every_seconds",
"grace_seconds",
"created_at_timestamp",
"created_at_datetime",
"expires_at_timestamp",
"expires_at_datetime",
"last_ping_at_timestamp",
"last_ping_at_datetime",
"next_expected_at_timestamp",
"next_expected_at_datetime",
"miss_due_at_timestamp",
"miss_due_at_datetime",
"ping_count",
"misses",
"late",
"on_miss",
"ping_url",
"status_url"
],
"properties": {
"ok": {
"type": "boolean"
},
"late": {
"type": "boolean"
},
"misses": {
"type": "integer"
},
"status": {
"enum": [
"armed",
"missed",
"fired",
"expired"
],
"type": "string"
},
"on_miss": {
"type": "object",
"required": [
"type"
],
"properties": {
"type": {
"enum": [
"webhook",
"agent_wake"
],
"type": "string"
}
},
"additionalProperties": false
},
"delivery": {
"type": "object"
},
"ping_url": {
"type": "string",
"format": "uri"
},
"ping_count": {
"type": "integer"
},
"status_url": {
"type": "string",
"format": "uri"
},
"heartbeat_id": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
"grace_seconds": {
"type": "integer"
},
"missed_at_datetime": {
"type": "string"
},
"created_at_datetime": {
"type": "string"
},
"expires_at_datetime": {
"type": "string"
},
"missed_at_timestamp": {
"type": "integer"
},
"created_at_timestamp": {
"type": "integer"
},
"expect_every_seconds": {
"type": "integer"
},
"expires_at_timestamp": {
"type": "integer"
},
"miss_due_at_datetime": {
"type": "string"
},
"terminal_at_datetime": {
"type": "string"
},
"last_ping_at_datetime": {
"type": "string"
},
"miss_due_at_timestamp": {
"type": "integer"
},
"terminal_at_timestamp": {
"type": "integer"
},
"last_ping_at_timestamp": {
"type": "integer"
},
"next_expected_at_datetime": {
"type": "string"
},
"next_expected_at_timestamp": {
"type": "integer"
}
},
"additionalProperties": true
}{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true
}ping_heartbeat — Ping heartbeat
Record a check-in for an armed heartbeat and move its next expected deadline. Use it after successful work or from a liveness loop. A ping does not extend the absolute 24 hour lifetime. The heartbeat ID is a bearer secret. No authentication is required.
{
"type": "object",
"required": [
"heartbeat_id"
],
"properties": {
"heartbeat_id": {
"type": "string",
"pattern": "^[a-f0-9]{64}$",
"description": "The secret heartbeat ID returned by create_heartbeat."
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"ok",
"heartbeat_id",
"status",
"expect_every_seconds",
"grace_seconds",
"created_at_timestamp",
"created_at_datetime",
"expires_at_timestamp",
"expires_at_datetime",
"last_ping_at_timestamp",
"last_ping_at_datetime",
"next_expected_at_timestamp",
"next_expected_at_datetime",
"miss_due_at_timestamp",
"miss_due_at_datetime",
"ping_count",
"misses",
"late",
"on_miss",
"ping_url",
"status_url"
],
"properties": {
"ok": {
"type": "boolean"
},
"late": {
"type": "boolean"
},
"misses": {
"type": "integer"
},
"status": {
"enum": [
"armed",
"missed",
"fired",
"expired"
],
"type": "string"
},
"on_miss": {
"type": "object",
"required": [
"type"
],
"properties": {
"type": {
"enum": [
"webhook",
"agent_wake"
],
"type": "string"
}
},
"additionalProperties": false
},
"delivery": {
"type": "object"
},
"ping_url": {
"type": "string",
"format": "uri"
},
"ping_count": {
"type": "integer"
},
"status_url": {
"type": "string",
"format": "uri"
},
"heartbeat_id": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
"grace_seconds": {
"type": "integer"
},
"missed_at_datetime": {
"type": "string"
},
"created_at_datetime": {
"type": "string"
},
"expires_at_datetime": {
"type": "string"
},
"missed_at_timestamp": {
"type": "integer"
},
"created_at_timestamp": {
"type": "integer"
},
"expect_every_seconds": {
"type": "integer"
},
"expires_at_timestamp": {
"type": "integer"
},
"miss_due_at_datetime": {
"type": "string"
},
"terminal_at_datetime": {
"type": "string"
},
"last_ping_at_datetime": {
"type": "string"
},
"miss_due_at_timestamp": {
"type": "integer"
},
"terminal_at_timestamp": {
"type": "integer"
},
"last_ping_at_timestamp": {
"type": "integer"
},
"next_expected_at_datetime": {
"type": "string"
},
"next_expected_at_timestamp": {
"type": "integer"
}
},
"additionalProperties": true
}{
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}create_lease_namespace — Create lease namespace
Create a random private namespace before several agents coordinate work using short readable keys. The namespace is a bearer secret and is returned once. Share it only with the cooperating agents. This operation stores no lease and needs no authentication.
{
"type": "object",
"properties": {},
"additionalProperties": false
}{
"type": "object",
"required": [
"ok",
"namespace",
"entropy_bits"
],
"properties": {
"ok": {
"type": "boolean"
},
"namespace": {
"type": "string",
"pattern": "^ns_[A-Za-z0-9_-]{43}$"
},
"entropy_bits": {
"type": "integer",
"const": 256
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": false
}acquire_lease — Acquire lease
Claim one unit of work so concurrent agents do not perform it twice. The first writer receives an owner token and a monotonic fencing token. A later caller receives held, conflict or a reusable completed result. Contention is a normal result. Use a private namespace, or supply a high-entropy unscoped key. No authentication is required.
{
"type": "object",
"required": [
"key"
],
"properties": {
"key": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Work identity. With a namespace use 1 to 128 URL-safe ASCII characters, starting with a letter or digit. Without one use a caller-generated secret of 32 to 200 ASCII characters from A-Z, a-z, 0-9, dot, underscore, colon, tilde or hyphen, with at least eight distinct characters."
},
"namespace": {
"type": "string",
"pattern": "^ns_[A-Za-z0-9_-]{43}$",
"description": "Optional 256-bit namespace from create_lease_namespace. Keep it secret."
},
"fingerprint": {
"type": "string",
"maxLength": 512,
"description": "Optional stable description or digest that binds this key to the same work."
},
"ttl_seconds": {
"type": "integer",
"default": 60,
"maximum": 86400,
"minimum": 1,
"description": "Ownership period, capped by the absolute 24 hour lifetime."
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"ok",
"status"
],
"properties": {
"ok": {
"type": "boolean"
},
"error": {
"type": "string"
},
"result": {},
"status": {
"enum": [
"held",
"conflict",
"lost",
"released",
"completed"
],
"type": "string"
},
"owner_token": {
"type": "string",
"pattern": "^own_[A-Za-z0-9_-]{43}$"
},
"ttl_seconds": {
"type": "integer",
"minimum": 0
},
"completed_at": {
"type": "string"
},
"fencing_token": {
"type": "integer",
"minimum": 1
},
"lease_expires_at": {
"type": "string"
},
"absolute_expires_at": {
"type": "string"
},
"retry_after_seconds": {
"type": "integer",
"minimum": 1
},
"completed_at_timestamp": {
"type": "integer"
},
"lease_expires_at_timestamp": {
"type": "integer"
},
"absolute_expires_at_timestamp": {
"type": "integer"
}
},
"additionalProperties": false
}{
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}renew_lease — Renew lease
Extend a lease that this caller still owns. Use it before the current TTL ends when work is still running. The owner token is required and must stay secret. Renewal cannot move the absolute 24 hour limit. No authentication is required.
{
"type": "object",
"required": [
"key",
"owner_token"
],
"properties": {
"key": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Work identity. With a namespace use 1 to 128 URL-safe ASCII characters, starting with a letter or digit. Without one use a caller-generated secret of 32 to 200 ASCII characters from A-Z, a-z, 0-9, dot, underscore, colon, tilde or hyphen, with at least eight distinct characters."
},
"namespace": {
"type": "string",
"pattern": "^ns_[A-Za-z0-9_-]{43}$",
"description": "Optional 256-bit namespace from create_lease_namespace. Keep it secret."
},
"owner_token": {
"type": "string",
"pattern": "^own_[A-Za-z0-9_-]{43}$",
"description": "Secret owner token returned by acquire_lease."
},
"ttl_seconds": {
"type": "integer",
"default": 60,
"maximum": 86400,
"minimum": 1,
"description": "The new lease length in seconds from now, 1 to 86400, default 60. It cannot pass the absolute 24 hour limit."
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"ok",
"status"
],
"properties": {
"ok": {
"type": "boolean"
},
"error": {
"type": "string"
},
"result": {},
"status": {
"enum": [
"held",
"conflict",
"lost",
"released",
"completed"
],
"type": "string"
},
"owner_token": {
"type": "string",
"pattern": "^own_[A-Za-z0-9_-]{43}$"
},
"ttl_seconds": {
"type": "integer",
"minimum": 0
},
"completed_at": {
"type": "string"
},
"fencing_token": {
"type": "integer",
"minimum": 1
},
"lease_expires_at": {
"type": "string"
},
"absolute_expires_at": {
"type": "string"
},
"retry_after_seconds": {
"type": "integer",
"minimum": 1
},
"completed_at_timestamp": {
"type": "integer"
},
"lease_expires_at_timestamp": {
"type": "integer"
},
"absolute_expires_at_timestamp": {
"type": "integer"
}
},
"additionalProperties": false
}{
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}release_lease — Release lease
Give up a lease before its TTL ends so another agent can acquire the work. Use it when abandoning work without a reusable result. The secret owner token is required. No authentication is required.
{
"type": "object",
"required": [
"key",
"owner_token"
],
"properties": {
"key": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Work identity. With a namespace use 1 to 128 URL-safe ASCII characters, starting with a letter or digit. Without one use a caller-generated secret of 32 to 200 ASCII characters from A-Z, a-z, 0-9, dot, underscore, colon, tilde or hyphen, with at least eight distinct characters."
},
"namespace": {
"type": "string",
"pattern": "^ns_[A-Za-z0-9_-]{43}$",
"description": "Optional 256-bit namespace from create_lease_namespace. Keep it secret."
},
"owner_token": {
"type": "string",
"pattern": "^own_[A-Za-z0-9_-]{43}$",
"description": "Secret owner token returned by acquire_lease."
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"ok",
"status"
],
"properties": {
"ok": {
"type": "boolean"
},
"error": {
"type": "string"
},
"result": {},
"status": {
"enum": [
"held",
"conflict",
"lost",
"released",
"completed"
],
"type": "string"
},
"owner_token": {
"type": "string",
"pattern": "^own_[A-Za-z0-9_-]{43}$"
},
"ttl_seconds": {
"type": "integer",
"minimum": 0
},
"completed_at": {
"type": "string"
},
"fencing_token": {
"type": "integer",
"minimum": 1
},
"lease_expires_at": {
"type": "string"
},
"absolute_expires_at": {
"type": "string"
},
"retry_after_seconds": {
"type": "integer",
"minimum": 1
},
"completed_at_timestamp": {
"type": "integer"
},
"lease_expires_at_timestamp": {
"type": "integer"
},
"absolute_expires_at_timestamp": {
"type": "integer"
}
},
"additionalProperties": false
}{
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}complete_lease — Complete lease
Finish owned work and save a reusable JSON result for later callers with the same identity and fingerprint. The result is limited to 32 KB and secret-shaped fields are redacted. Do not store secrets or personal data. The owner token is required. No authentication is required.
{
"type": "object",
"required": [
"key",
"owner_token",
"result"
],
"properties": {
"key": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Work identity. With a namespace use 1 to 128 URL-safe ASCII characters, starting with a letter or digit. Without one use a caller-generated secret of 32 to 200 ASCII characters from A-Z, a-z, 0-9, dot, underscore, colon, tilde or hyphen, with at least eight distinct characters."
},
"result": {
"description": "Reusable JSON value. Maximum encoded size is 32 KB. Do not include secrets."
},
"namespace": {
"type": "string",
"pattern": "^ns_[A-Za-z0-9_-]{43}$",
"description": "Optional 256-bit namespace from create_lease_namespace. Keep it secret."
},
"owner_token": {
"type": "string",
"pattern": "^own_[A-Za-z0-9_-]{43}$",
"description": "Secret owner token returned by acquire_lease."
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"ok",
"status"
],
"properties": {
"ok": {
"type": "boolean"
},
"error": {
"type": "string"
},
"result": {},
"status": {
"enum": [
"held",
"conflict",
"lost",
"released",
"completed"
],
"type": "string"
},
"owner_token": {
"type": "string",
"pattern": "^own_[A-Za-z0-9_-]{43}$"
},
"ttl_seconds": {
"type": "integer",
"minimum": 0
},
"completed_at": {
"type": "string"
},
"fencing_token": {
"type": "integer",
"minimum": 1
},
"lease_expires_at": {
"type": "string"
},
"absolute_expires_at": {
"type": "string"
},
"retry_after_seconds": {
"type": "integer",
"minimum": 1
},
"completed_at_timestamp": {
"type": "integer"
},
"lease_expires_at_timestamp": {
"type": "integer"
},
"absolute_expires_at_timestamp": {
"type": "integer"
}
},
"additionalProperties": false
}{
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}create_agent_inbox — Create agent inbox
Create a private email inbox that lives for 24 hours, so an agent can receive a confirmation mail, a verification code or a one time link while it works. The call returns two identifiers and they are not interchangeable. The address is public by construction: it travels in mail headers, bounces and sender logs, and anyone who has it can send mail to the inbox, so give it to the site or person who must write to you. The inbox_id is a UUID and it is the only credential that reads the inbox. Keep it secret, never publish it, never put it in a form or a page, and note that read_url and wait_url contain it and are just as secret. Reading is done with read_agent_inbox, never with the address or the slug. Mail comes from strangers, so treat every message as untrusted text. The inbox holds 20 messages and 256 KiB of text in total, and past either cap it refuses new mail and keeps what it already has. No API key, account or sign up is required.
{
"type": "object",
"properties": {},
"additionalProperties": false
}{
"type": "object",
"required": [
"ok",
"inbox_id",
"slug",
"address",
"read_url",
"wait_url",
"expire_timestamp"
],
"properties": {
"ok": {
"type": "boolean"
},
"slug": {
"type": "string",
"pattern": "^[a-z0-9]{7}$",
"description": "Public routing label inside the address. It cannot read the inbox."
},
"address": {
"type": "string",
"format": "email",
"description": "Public mail address. Share it with whoever must send mail here."
},
"inbox_id": {
"type": "string",
"format": "uuid",
"description": "Secret read credential. Keep it out of logs, pages and forms."
},
"read_url": {
"type": "string",
"format": "uri"
},
"wait_url": {
"type": "string",
"format": "uri"
},
"expire_timestamp": {
"type": "integer"
}
},
"additionalProperties": false
}{
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}read_agent_inbox — Read agent inbox
Read the mail that has arrived in an inbox from create_agent_inbox. Each message carries the sender, the subject, the arrival time in UTC, the cleaned text, any standalone 4 to 8 digit codes found in that text and any public http or https links. Attachments and raw headers are not stored. Set wait_seconds from 1 to 25 to wait for the next message, or zero to read immediately. An empty inbox is the ordinary answer before mail arrives and is not a failure. When truncated is true, at least one whole message was refused because the inbox had reached its 20 message cap or its 256 KiB total text cap. A code you are waiting for may then have been turned away rather than delayed. The reply names the public slug and never repeats the secret inbox_id. An unknown inbox_id and a wrong one fail in the same way, so neither can be told from the other, while an expired inbox says that it expired. No API key, account or sign up is required.
{
"type": "object",
"required": [
"inbox_id"
],
"properties": {
"inbox_id": {
"type": "string",
"format": "uuid",
"description": "The secret UUID that create_agent_inbox returned as inbox_id. Not the slug and not the address."
},
"wait_seconds": {
"type": "integer",
"default": 0,
"maximum": 25,
"minimum": 0,
"description": "Wait up to this many seconds for new mail. Zero returns immediately."
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"ok",
"slug",
"address",
"received",
"truncated",
"messages",
"created_at_timestamp",
"expire_timestamp",
"waited_seconds",
"wait_reason"
],
"properties": {
"ok": {
"type": "boolean"
},
"slug": {
"type": "string",
"pattern": "^[a-z0-9]{7}$"
},
"address": {
"type": "string",
"format": "email"
},
"messages": {
"type": "array",
"items": {
"type": "object",
"required": [
"from",
"subject",
"date",
"text",
"codes",
"links"
],
"properties": {
"date": {
"type": "string",
"description": "Arrival time in UTC, for example 2026-01-31T09:15:00Z. It records when the mail reached the mailbox, and falls back to the Date header written by the sender only when that arrival time is missing."
},
"from": {
"type": "string"
},
"text": {
"type": "string"
},
"codes": {
"type": "array",
"items": {
"type": "string"
}
},
"links": {
"type": "array",
"items": {
"type": "string"
}
},
"subject": {
"type": "string"
}
},
"additionalProperties": false
}
},
"received": {
"type": "integer",
"minimum": 0
},
"truncated": {
"type": "boolean",
"description": "True once at least one whole message has been refused, by the 20 message cap or by the 256 KiB total text cap. Messages already stored are kept."
},
"wait_reason": {
"enum": [
"terminal",
"changed",
"timeout",
"immediate",
"unavailable",
"stalled"
],
"type": "string"
},
"waited_seconds": {
"type": "number",
"minimum": 0
},
"expire_timestamp": {
"type": "integer"
},
"created_at_timestamp": {
"type": "integer"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true
}create_agent_queue — Create agent queue
Create a small temporary pull queue for cooperating agents. Its fixed 24 hour lifetime cannot be extended. Returns separate read, write and worker bearer tokens once. Keep them secret and share only the role needed. Maximum 100 jobs over the queue lifetime, 16 KiB per JSON payload, 5 claims per job and 20 queues per client IP in 24 hours. The server does not execute jobs. No account or API key is required.
{
"type": "object",
"properties": {},
"additionalProperties": false
}{
"type": "object",
"required": [
"ok",
"queue_id",
"created_at_timestamp",
"expire_timestamp",
"counts",
"read_token",
"write_token",
"worker_token"
],
"properties": {
"ok": {
"type": "boolean"
},
"counts": {
"type": "object",
"required": [
"pending",
"claimed",
"completed",
"failed",
"total"
],
"properties": {
"total": {
"type": "integer",
"maximum": 100,
"minimum": 0
},
"failed": {
"type": "integer",
"maximum": 100,
"minimum": 0
},
"claimed": {
"type": "integer",
"maximum": 100,
"minimum": 0
},
"pending": {
"type": "integer",
"maximum": 100,
"minimum": 0
},
"completed": {
"type": "integer",
"maximum": 100,
"minimum": 0
}
},
"additionalProperties": false
},
"queue_id": {
"type": "string",
"pattern": "^[a-f0-9]{32}$"
},
"read_token": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
"write_token": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
"worker_token": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
"expire_timestamp": {
"type": "integer"
},
"created_at_timestamp": {
"type": "integer"
}
},
"additionalProperties": false
}{
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}read_agent_queue — Read agent queue
Read queue metadata and pending, claimed, completed and failed counts using the read token. Does not list payloads, disclose role tokens or extend the fixed expiry.
{
"type": "object",
"required": [
"queue_id",
"read_token"
],
"properties": {
"queue_id": {
"type": "string",
"pattern": "^[a-f0-9]{32}$",
"description": "The queue_id from create_agent_queue, or from create_agent_run for a run with delegated steps."
},
"read_token": {
"type": "string",
"pattern": "^[a-f0-9]{64}$",
"description": "The read_token from create_agent_queue, shown once. It reads the queue and its jobs."
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"ok",
"queue_id",
"created_at_timestamp",
"expire_timestamp",
"counts"
],
"properties": {
"ok": {
"type": "boolean"
},
"counts": {
"type": "object",
"required": [
"pending",
"claimed",
"completed",
"failed",
"total"
],
"properties": {
"total": {
"type": "integer",
"maximum": 100,
"minimum": 0
},
"failed": {
"type": "integer",
"maximum": 100,
"minimum": 0
},
"claimed": {
"type": "integer",
"maximum": 100,
"minimum": 0
},
"pending": {
"type": "integer",
"maximum": 100,
"minimum": 0
},
"completed": {
"type": "integer",
"maximum": 100,
"minimum": 0
}
},
"additionalProperties": false
},
"queue_id": {
"type": "string",
"pattern": "^[a-f0-9]{32}$"
},
"expire_timestamp": {
"type": "integer"
},
"created_at_timestamp": {
"type": "integer"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true
}enqueue_agent_queue_job — Enqueue agent queue job
Add a JSON job using the write token and a stable job_key. The same key and payload return the original job. Changing the payload for that key is a conflict. Payloads are limited to 16 KiB encoded JSON and must contain no secrets or personal data. The 100-job lifetime limit includes completed and failed jobs.
{
"type": "object",
"required": [
"queue_id",
"write_token",
"job_key",
"payload"
],
"properties": {
"job_key": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,63}$",
"maxLength": 64,
"minLength": 1,
"description": "Your own stable key for the job, 1 to 64 characters. A repeat with the same key and payload returns the original job."
},
"payload": {
"description": "Required JSON value, including null. Maximum encoded size: 16384 bytes."
},
"queue_id": {
"type": "string",
"pattern": "^[a-f0-9]{32}$",
"description": "The queue_id from create_agent_queue, or from create_agent_run for a run with delegated steps."
},
"write_token": {
"type": "string",
"pattern": "^[a-f0-9]{64}$",
"description": "The write_token from create_agent_queue, shown once. It adds jobs."
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"ok",
"queue_id",
"expire_timestamp",
"job",
"deduplicated"
],
"properties": {
"ok": {
"type": "boolean"
},
"job": {
"type": "object",
"required": [
"job_id",
"job_key",
"payload",
"status",
"attempts",
"created_at_timestamp",
"expire_timestamp",
"claimed_until_timestamp"
],
"properties": {
"job_id": {
"type": "string",
"pattern": "^[a-f0-9]{32}$"
},
"status": {
"enum": [
"pending",
"claimed",
"completed",
"failed"
],
"type": "string"
},
"job_key": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,63}$",
"maxLength": 64,
"minLength": 1
},
"payload": {},
"attempts": {
"type": "integer",
"maximum": 5,
"minimum": 0
},
"expire_timestamp": {
"type": "integer"
},
"created_at_timestamp": {
"type": "integer"
},
"claimed_until_timestamp": {
"type": [
"integer",
"null"
]
}
},
"additionalProperties": false
},
"queue_id": {
"type": "string",
"pattern": "^[a-f0-9]{32}$"
},
"deduplicated": {
"type": "boolean"
},
"expire_timestamp": {
"type": "integer"
}
},
"additionalProperties": false
}{
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}read_agent_queue_job — Read agent queue job
Read one known job, its JSON payload and status using the read token. The active claim receipt and role tokens are never returned by this operation.
{
"type": "object",
"required": [
"queue_id",
"job_id",
"read_token"
],
"properties": {
"job_id": {
"type": "string",
"pattern": "^[a-f0-9]{32}$",
"description": "The job_id from enqueue_agent_queue_job or claim_agent_queue_job."
},
"queue_id": {
"type": "string",
"pattern": "^[a-f0-9]{32}$",
"description": "The queue_id from create_agent_queue, or from create_agent_run for a run with delegated steps."
},
"read_token": {
"type": "string",
"pattern": "^[a-f0-9]{64}$",
"description": "The read_token from create_agent_queue, shown once. It reads the queue and its jobs."
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"ok",
"queue_id",
"expire_timestamp",
"job"
],
"properties": {
"ok": {
"type": "boolean"
},
"job": {
"type": "object",
"required": [
"job_id",
"job_key",
"payload",
"status",
"attempts",
"created_at_timestamp",
"expire_timestamp",
"claimed_until_timestamp"
],
"properties": {
"job_id": {
"type": "string",
"pattern": "^[a-f0-9]{32}$"
},
"status": {
"enum": [
"pending",
"claimed",
"completed",
"failed"
],
"type": "string"
},
"job_key": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,63}$",
"maxLength": 64,
"minLength": 1
},
"payload": {},
"attempts": {
"type": "integer",
"maximum": 5,
"minimum": 0
},
"expire_timestamp": {
"type": "integer"
},
"created_at_timestamp": {
"type": "integer"
},
"claimed_until_timestamp": {
"type": [
"integer",
"null"
]
}
},
"additionalProperties": false
},
"queue_id": {
"type": "string",
"pattern": "^[a-f0-9]{32}$"
},
"expire_timestamp": {
"type": "integer"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true
}claim_agent_queue_job — Claim agent queue job
Claim the next pending job using the worker token. Returns job:null immediately when no work is available, otherwise a job containing a new secret receipt. Visibility defaults to 60 seconds and accepts 30-900 seconds. Redelivery is possible: make worker side effects idempotent. Jobs fail after 5 unsuccessful claims. No job is executed by the server.
{
"type": "object",
"required": [
"queue_id",
"worker_token"
],
"properties": {
"queue_id": {
"type": "string",
"pattern": "^[a-f0-9]{32}$",
"description": "The queue_id from create_agent_queue, or from create_agent_run for a run with delegated steps."
},
"worker_token": {
"type": "string",
"pattern": "^[a-f0-9]{64}$",
"description": "The worker_token from create_agent_queue or create_agent_run, shown once. It claims jobs and acknowledges, renews or releases them."
},
"visibility_timeout": {
"type": "integer",
"default": 60,
"maximum": 900,
"minimum": 30,
"description": "Claim visibility in seconds, capped by the fixed queue expiry."
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"ok",
"queue_id",
"expire_timestamp",
"job"
],
"properties": {
"ok": {
"type": "boolean"
},
"job": {
"oneOf": [
{
"type": "object",
"required": [
"job_id",
"job_key",
"payload",
"status",
"attempts",
"created_at_timestamp",
"expire_timestamp",
"claimed_until_timestamp",
"receipt"
],
"properties": {
"job_id": {
"type": "string",
"pattern": "^[a-f0-9]{32}$"
},
"status": {
"enum": [
"pending",
"claimed",
"completed",
"failed"
],
"type": "string"
},
"job_key": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,63}$",
"maxLength": 64,
"minLength": 1
},
"payload": {},
"receipt": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
"attempts": {
"type": "integer",
"maximum": 5,
"minimum": 0
},
"expire_timestamp": {
"type": "integer"
},
"created_at_timestamp": {
"type": "integer"
},
"claimed_until_timestamp": {
"type": [
"integer",
"null"
]
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"queue_id": {
"type": "string",
"pattern": "^[a-f0-9]{32}$"
},
"expire_timestamp": {
"type": "integer"
}
},
"additionalProperties": false
}{
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}ack_agent_queue_job — Acknowledge agent queue job
Mark a claimed job completed using the worker token and its current receipt. Repeating acknowledgement with the same winning receipt succeeds. A different, stale or expired claim receipt is a conflict. Completion does not reclaim the lifetime job allowance.
{
"type": "object",
"required": [
"queue_id",
"job_id",
"worker_token",
"receipt"
],
"properties": {
"job_id": {
"type": "string",
"pattern": "^[a-f0-9]{32}$",
"description": "The job_id of the claimed job."
},
"receipt": {
"type": "string",
"pattern": "^[a-f0-9]{64}$",
"description": "The receipt from the current claim. A newer claim or a release makes it stale."
},
"queue_id": {
"type": "string",
"pattern": "^[a-f0-9]{32}$",
"description": "The queue_id from create_agent_queue, or from create_agent_run for a run with delegated steps."
},
"worker_token": {
"type": "string",
"pattern": "^[a-f0-9]{64}$",
"description": "The worker_token from create_agent_queue or create_agent_run, shown once. It claims jobs and acknowledges, renews or releases them."
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"ok",
"queue_id",
"expire_timestamp",
"job"
],
"properties": {
"ok": {
"type": "boolean"
},
"job": {
"type": "object",
"required": [
"job_id",
"job_key",
"payload",
"status",
"attempts",
"created_at_timestamp",
"expire_timestamp",
"claimed_until_timestamp"
],
"properties": {
"job_id": {
"type": "string",
"pattern": "^[a-f0-9]{32}$"
},
"status": {
"enum": [
"pending",
"claimed",
"completed",
"failed"
],
"type": "string"
},
"job_key": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,63}$",
"maxLength": 64,
"minLength": 1
},
"payload": {},
"attempts": {
"type": "integer",
"maximum": 5,
"minimum": 0
},
"expire_timestamp": {
"type": "integer"
},
"created_at_timestamp": {
"type": "integer"
},
"claimed_until_timestamp": {
"type": [
"integer",
"null"
]
}
},
"additionalProperties": false
},
"queue_id": {
"type": "string",
"pattern": "^[a-f0-9]{32}$"
},
"expire_timestamp": {
"type": "integer"
}
},
"additionalProperties": false
}{
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": true
}release_agent_queue_job — Release agent queue job
Return a claimed job to pending using the worker token and its current receipt. On the fifth claim it becomes failed. The receipt is invalidated. Stale receipts conflict.
{
"type": "object",
"required": [
"queue_id",
"job_id",
"worker_token",
"receipt"
],
"properties": {
"job_id": {
"type": "string",
"pattern": "^[a-f0-9]{32}$",
"description": "The job_id of the claimed job."
},
"receipt": {
"type": "string",
"pattern": "^[a-f0-9]{64}$",
"description": "The receipt from the current claim. A newer claim or a release makes it stale."
},
"queue_id": {
"type": "string",
"pattern": "^[a-f0-9]{32}$",
"description": "The queue_id from create_agent_queue, or from create_agent_run for a run with delegated steps."
},
"worker_token": {
"type": "string",
"pattern": "^[a-f0-9]{64}$",
"description": "The worker_token from create_agent_queue or create_agent_run, shown once. It claims jobs and acknowledges, renews or releases them."
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"ok",
"queue_id",
"expire_timestamp",
"job"
],
"properties": {
"ok": {
"type": "boolean"
},
"job": {
"type": "object",
"required": [
"job_id",
"job_key",
"payload",
"status",
"attempts",
"created_at_timestamp",
"expire_timestamp",
"claimed_until_timestamp"
],
"properties": {
"job_id": {
"type": "string",
"pattern": "^[a-f0-9]{32}$"
},
"status": {
"enum": [
"pending",
"claimed",
"completed",
"failed"
],
"type": "string"
},
"job_key": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,63}$",
"maxLength": 64,
"minLength": 1
},
"payload": {},
"attempts": {
"type": "integer",
"maximum": 5,
"minimum": 0
},
"expire_timestamp": {
"type": "integer"
},
"created_at_timestamp": {
"type": "integer"
},
"claimed_until_timestamp": {
"type": [
"integer",
"null"
]
}
},
"additionalProperties": false
},
"queue_id": {
"type": "string",
"pattern": "^[a-f0-9]{32}$"
},
"expire_timestamp": {
"type": "integer"
}
},
"additionalProperties": false
}{
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": true
}renew_agent_queue_job — Renew agent queue job
Move the active claim deadline using the worker token and current receipt. Visibility accepts 30-900 seconds, defaults to 60 seconds and is capped by the original queue expiry. A stale or expired receipt is a conflict. Queue lifetime is never extended.
{
"type": "object",
"required": [
"queue_id",
"job_id",
"worker_token",
"receipt"
],
"properties": {
"job_id": {
"type": "string",
"pattern": "^[a-f0-9]{32}$",
"description": "The job_id of the claimed job."
},
"receipt": {
"type": "string",
"pattern": "^[a-f0-9]{64}$",
"description": "The receipt from the current claim. A newer claim or a release makes it stale."
},
"queue_id": {
"type": "string",
"pattern": "^[a-f0-9]{32}$",
"description": "The queue_id from create_agent_queue, or from create_agent_run for a run with delegated steps."
},
"worker_token": {
"type": "string",
"pattern": "^[a-f0-9]{64}$",
"description": "The worker_token from create_agent_queue or create_agent_run, shown once. It claims jobs and acknowledges, renews or releases them."
},
"visibility_timeout": {
"type": "integer",
"default": 60,
"maximum": 900,
"minimum": 30,
"description": "Claim visibility in seconds, capped by the fixed queue expiry."
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"ok",
"queue_id",
"expire_timestamp",
"job"
],
"properties": {
"ok": {
"type": "boolean"
},
"job": {
"type": "object",
"required": [
"job_id",
"job_key",
"payload",
"status",
"attempts",
"created_at_timestamp",
"expire_timestamp",
"claimed_until_timestamp"
],
"properties": {
"job_id": {
"type": "string",
"pattern": "^[a-f0-9]{32}$"
},
"status": {
"enum": [
"pending",
"claimed",
"completed",
"failed"
],
"type": "string"
},
"job_key": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,63}$",
"maxLength": 64,
"minLength": 1
},
"payload": {},
"attempts": {
"type": "integer",
"maximum": 5,
"minimum": 0
},
"expire_timestamp": {
"type": "integer"
},
"created_at_timestamp": {
"type": "integer"
},
"claimed_until_timestamp": {
"type": [
"integer",
"null"
]
}
},
"additionalProperties": false
},
"queue_id": {
"type": "string",
"pattern": "^[a-f0-9]{32}$"
},
"expire_timestamp": {
"type": "integer"
}
},
"additionalProperties": false
}{
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}create_dns_name — Create a temporary DNS name
Point a public hostname at an address you already control, for 24 hours. Use it when something needs a name rather than an address: a webhook target someone has to type, a staging box whose address moves, a service two agents must reach by the same name. No API key, no account and no sign up. The name is assigned and never chosen, and comes back as aisense-<slug>.53for24h.com. The answer carries dns_token once and never again; without it the name cannot be changed or removed. It disappears on its own after 24 hours and nothing extends that. A name is a DNS record and nothing else: no tunnel, no hosting, no certificate and no HTTPS. The zone is not on the Public Suffix List, so every name shares one certificate quota and browsers treat them as one site. Do not put a login on one.
{
"type": "object",
"required": [
"ip"
],
"properties": {
"ip": {
"type": "string",
"maxLength": 45,
"description": "A public unicast IPv4 or IPv6 address. Private, loopback, link-local and multicast ranges are refused. The address is required and never taken from the caller, because the caller is usually not the machine the name should point at."
},
"ttl": {
"enum": [
60
],
"type": "integer",
"description": "Seconds. 60 is the only value on the menu, so leave it out unless you want to be explicit."
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"ok",
"name",
"slug",
"ip",
"record",
"ttl",
"nameservers",
"expire_timestamp",
"expire_at",
"dns_token"
],
"properties": {
"ip": {
"type": "string"
},
"ok": {
"type": "boolean"
},
"ttl": {
"type": "integer"
},
"name": {
"type": "string"
},
"slug": {
"type": "string"
},
"record": {
"enum": [
"A",
"AAAA"
],
"type": "string"
},
"serial": {
"type": "integer"
},
"dns_token": {
"type": "string"
},
"expire_at": {
"type": "string"
},
"nameservers": {
"type": "array",
"items": {
"type": "string"
}
},
"expire_timestamp": {
"type": "integer"
},
"created_at_timestamp": {
"type": "integer"
}
}
}{
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}read_dns_name — Read a temporary DNS name
Look up what a temporary DNS name points at and how long it has left. No token is needed: everything it returns is already public in DNS. Use it to confirm a name exists and resolves the way you expect before handing it to someone else. It fails once the name has expired, and a name stops answering in the same second it falls due.
{
"type": "object",
"required": [
"slug"
],
"properties": {
"slug": {
"type": "string",
"pattern": "^[a-z0-9]{7}$",
"maxLength": 7,
"minLength": 7,
"description": "The slug the service assigned, without the aisense- prefix and without the zone."
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"ok",
"name",
"slug",
"ip",
"record",
"ttl",
"nameservers",
"expire_timestamp",
"expire_at"
],
"properties": {
"ip": {
"type": "string"
},
"ok": {
"type": "boolean"
},
"ttl": {
"type": "integer"
},
"name": {
"type": "string"
},
"slug": {
"type": "string"
},
"record": {
"enum": [
"A",
"AAAA"
],
"type": "string"
},
"serial": {
"type": "integer"
},
"expire_at": {
"type": "string"
},
"nameservers": {
"type": "array",
"items": {
"type": "string"
}
},
"expire_timestamp": {
"type": "integer"
},
"created_at_timestamp": {
"type": "integer"
}
}
}{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}update_dns_name — Update a temporary DNS name
Change the address a temporary DNS name points at. Needs the dns_token from create_dns_name. Use it when the machine behind the name moved and you would rather keep the name than hand out a new one. The expiry does not move: the name still disappears 24 hours after it was created. One change per name per 10 seconds.
{
"type": "object",
"required": [
"slug",
"dns_token"
],
"properties": {
"ip": {
"type": "string",
"maxLength": 45,
"description": "A public unicast IPv4 or IPv6 address. Private, loopback, link-local and multicast ranges are refused. The address is required and never taken from the caller, because the caller is usually not the machine the name should point at."
},
"ttl": {
"enum": [
60
],
"type": "integer",
"description": "Seconds. 60 is the only value on the menu, so leave it out unless you want to be explicit."
},
"slug": {
"type": "string",
"pattern": "^[a-z0-9]{7}$",
"maxLength": 7,
"minLength": 7,
"description": "The slug the service assigned, without the aisense- prefix and without the zone."
},
"dns_token": {
"type": "string",
"maxLength": 128,
"minLength": 16,
"description": "The dns_token from create_dns_name. It is shown once and never again."
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"ok",
"name",
"slug",
"ip",
"record",
"ttl",
"nameservers",
"expire_timestamp",
"expire_at"
],
"properties": {
"ip": {
"type": "string"
},
"ok": {
"type": "boolean"
},
"ttl": {
"type": "integer"
},
"name": {
"type": "string"
},
"slug": {
"type": "string"
},
"record": {
"enum": [
"A",
"AAAA"
],
"type": "string"
},
"serial": {
"type": "integer"
},
"expire_at": {
"type": "string"
},
"nameservers": {
"type": "array",
"items": {
"type": "string"
}
},
"expire_timestamp": {
"type": "integer"
},
"created_at_timestamp": {
"type": "integer"
}
}
}{
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}delete_dns_name — Delete a temporary DNS name
Remove a temporary DNS name now, before its 24 hours are up. Needs the dns_token. Use it when the work is done and the name should stop answering rather than sit there until it expires. The removal reaches the primary name server at once and the secondary follows by replication, so a disconnected secondary can keep answering until it reconnects or the name expires. A resolver that already holds the answer keeps it for the rest of its TTL, at most 60 seconds.
{
"type": "object",
"required": [
"slug",
"dns_token"
],
"properties": {
"slug": {
"type": "string",
"pattern": "^[a-z0-9]{7}$",
"maxLength": 7,
"minLength": 7,
"description": "The slug the service assigned, without the aisense- prefix and without the zone."
},
"dns_token": {
"type": "string",
"maxLength": 128,
"minLength": 16,
"description": "The dns_token from create_dns_name. It is shown once and never again."
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"ok",
"name",
"slug",
"deleted"
],
"properties": {
"ok": {
"type": "boolean"
},
"name": {
"type": "string"
},
"slug": {
"type": "string"
},
"serial": {
"type": "integer"
},
"deleted": {
"type": "boolean"
}
}
}{
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": true
}encode_data — Encode or decode Base64, Base32, Base58, hex, URL or HTML
Encode text as Base64, Base64url, Base32, Base58 or hex, as URL percent-encoding or as HTML entities, or decode such a string. Decoding answers decoded_text when the bytes are UTF-8 text and decoded_base64 when they are binary. Base58 uses the Bitcoin alphabet and takes at most 64 KiB, base64url the URL-safe alphabet without padding, url RFC 3986 percent-encoding with a space as %20. No API key, no account and no sign up.
{
"type": "object",
"required": [
"operation",
"format",
"data"
],
"properties": {
"data": {
"type": "string",
"maxLength": 250000,
"minLength": 1,
"description": "Text to encode, or the encoded string to decode."
},
"format": {
"enum": [
"base64",
"base64url",
"base32",
"base58",
"hex",
"url",
"html"
],
"type": "string",
"description": "base64, base64url without padding, base32, base58 with the Bitcoin alphabet, hex, url percent-encoding or html entities."
},
"operation": {
"enum": [
"encode",
"decode"
],
"type": "string",
"description": "encode turns data into the chosen format; decode turns an encoded string back into text or bytes."
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true
}encode_audio — Encode data as sound
Turn 1 to 128 bytes into a PCM16 WAV audio block using the AI SENSE audio-v1 modem. data is UTF-8 text unless input_encoding is base64. Audible tones are the default. high uses experimental tones from 14.8 to 16.0 kHz and ultrasound experimental tones from 18.5 to 19.7 kHz. Both can be audible and depend on the devices. Play the audio near a listening device, then decode its recording. This encoding is unencrypted. Nothing is stored. No API key, no account and no sign up.
{
"type": "object",
"required": [
"data"
],
"properties": {
"data": {
"type": "string",
"maxLength": 172,
"minLength": 1,
"description": "UTF-8 text or standard Base64 representing at most 128 bytes."
},
"mode": {
"enum": [
"audible",
"high",
"ultrasound"
],
"type": "string",
"description": "audible by default. high and ultrasound are experimental and depend on the speakers and microphone."
},
"input_encoding": {
"enum": [
"utf8",
"base64"
],
"type": "string",
"description": "utf8 by default. Choose base64 for arbitrary binary bytes."
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true
}decode_audio — Decode data from sound
Recover one checksum-verified AI SENSE audio-v1 message from a PCM16 WAV recording at 44100 or 48000 Hz, mono or stereo, at most 40 seconds. Give storage_id for a WAV file of at most 4 MiB, uploaded through REST Storage first. WAV recordings exceed the inline MCP request limit. REST accepts files up to 8 MiB. Answers data_base64, byte_length and text when the recovered bytes are valid UTF-8. This is data-over-sound decoding, not speech transcription. Audio is processed by the API, and the decoded result is not stored. Stored input keeps its original lifetime. storage_id must name an ordinary 24-hour file, without a max_downloads limit. No API key, no account and no sign up.
{
"type": "object",
"required": [
"storage_id"
],
"properties": {
"mode": {
"enum": [
"auto",
"audible",
"high",
"ultrasound"
],
"type": "string",
"description": "auto tries all three bands within one shared time limit. Pick audible, high or ultrasound when known."
},
"storage_id": {
"type": "string",
"pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$",
"description": "A storage_id from store_file, from a previous tool result, or from REST /storage. Objects expire 24 hours after they were stored."
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true
}hash_data — Hash text
Hash text with MD5, SHA-1, SHA-256, SHA-512, CRC32, Whirlpool, SHA3-256, SHA3-512, BLAKE2b-256 or BLAKE3 and answer the digest in hex, or for crc32 as an integer. Use sha256, sha3_256, blake2b or blake3 for integrity checks; md5 and sha1 are for systems that still expect them. argon2id, bcrypt and scrypt are password hashes: slow by design, salted, answered as a self-describing string, limited to 200 calls per day, and meant for test data, since a real password should be hashed where it is used. No API key, no account and no sign up.
{
"type": "object",
"required": [
"algorithm",
"data"
],
"properties": {
"data": {
"type": "string",
"maxLength": 250000,
"minLength": 1,
"description": "The text to hash, as UTF-8."
},
"algorithm": {
"enum": [
"md5",
"sha1",
"sha256",
"sha512",
"crc32",
"whirlpool",
"sha3_256",
"sha3_512",
"blake2b",
"blake3",
"argon2id",
"bcrypt",
"scrypt"
],
"type": "string",
"description": "The hash function. argon2id, bcrypt and scrypt are slow, salted password hashes limited to 200 calls a day; the others answer a digest."
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true
}verify_hash — Verify a hash
Check that text matches a hash. Name the algorithm when you know it. Without it the algorithm follows from the hash: 8, 32, 40, 64 or 128 hex characters mean CRC32, MD5, SHA-1, SHA-256 or SHA-512, and an integer means CRC32 in decimal; whirlpool, sha3_256, sha3_512, blake2b and blake3 share those lengths and must be named. For argon2id, bcrypt and scrypt the hash is the salted string those algorithms answered; the cost is read from it and must be within what this service produces. Answers match and algorithm, with computed for digests and params for password hashes. No API key, no account and no sign up.
{
"type": "object",
"required": [
"data",
"hash"
],
"properties": {
"data": {
"type": "string",
"maxLength": 250000,
"minLength": 1,
"description": "The text to check against the hash."
},
"hash": {
"type": [
"string",
"integer"
],
"description": "The hash to compare against."
},
"algorithm": {
"enum": [
"md5",
"sha1",
"sha256",
"sha512",
"crc32",
"whirlpool",
"sha3_256",
"sha3_512",
"blake2b",
"blake3",
"argon2id",
"bcrypt",
"scrypt"
],
"type": "string",
"description": "Optional for the first five, required for the rest."
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true
}generate_random — Generate a random value
Generate a random number in a range (kind number, from and to, default 1 to 6), a color as #rrggbb (color), a GUID (guid), a password of 6 to 128 characters (password, length, default 12) or a passphrase of 2 to 12 word groups (passphrase, groups, default 4), which comes with its entropy in bits. UUIDs come from generate_uuid. No API key, no account and no sign up.
{
"type": "object",
"required": [
"kind"
],
"properties": {
"to": {
"type": "integer",
"maximum": 1000000000000,
"minimum": -1000000000000,
"description": "number only."
},
"from": {
"type": "integer",
"maximum": 1000000000000,
"minimum": -1000000000000,
"description": "number only."
},
"kind": {
"enum": [
"number",
"color",
"guid",
"password",
"passphrase"
],
"type": "string",
"description": "number for an integer between from and to, color for #rrggbb, guid, password for a password of length characters, or passphrase for groups word groups."
},
"groups": {
"type": "integer",
"maximum": 12,
"minimum": 2,
"description": "passphrase only."
},
"length": {
"type": "integer",
"maximum": 128,
"minimum": 6,
"description": "password only."
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": false
}time_formats — Current time in several formats
The current time in several formats at once: a Unix timestamp, Unix time with microseconds, an ISO 8601 date and time at an optional UTC offset, and Swatch Internet Time. Named timezones such as Europe/Oslo are answered by get_current_time. No API key, no account and no sign up.
{
"type": "object",
"properties": {
"offset": {
"type": "string",
"pattern": "^[+-](0[0-9]|1[0-2])[0-5][0-9]$",
"description": "UTC offset as a sign and four digits, from -1200 to +1200, for example +0200 or -0530."
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": false
}convert_timestamp — Convert a timestamp or date
Convert a Unix timestamp in seconds or milliseconds, or a date and time text, into a Unix timestamp, ISO 8601, RFC 2822 and UTC forms. offset sets the zone of the answer. The answer says what the input was read as. No API key, no account and no sign up.
{
"type": "object",
"required": [
"value"
],
"properties": {
"value": {
"type": [
"string",
"integer",
"number"
],
"description": "A Unix timestamp, or a date and time text such as 2026-09-30 14:00."
},
"offset": {
"type": "string",
"pattern": "^[+-](0[0-9]|1[0-2])[0-5][0-9]$",
"description": "UTC offset as a sign and four digits, from -1200 to +1200, for example +0200 or -0530."
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true
}list_timezones — List timezones
List the IANA timezones with their current UTC offsets, optionally only those at one offset such as +0530. No API key, no account and no sign up.
{
"type": "object",
"properties": {
"offset": {
"type": "string",
"pattern": "^[+-](0[0-9]|1[0-4])[0-5][0-9]$",
"description": "UTC offset such as +0530, from -1400 to +1400."
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true
}lookup_network — Network lookup
Network facts: the public IP address this service sees for you (client_ip), your User-Agent (user_agent), the country, city, coordinates and timezone of an IPv4 address from a local GeoLite2 database (reverse_ip), or the first IPv4 address a domain resolves to (domain_ip). value is the address or domain for the last two. No API key, no account and no sign up.
{
"type": "object",
"required": [
"kind"
],
"properties": {
"kind": {
"enum": [
"client_ip",
"user_agent",
"reverse_ip",
"domain_ip"
],
"type": "string",
"description": "client_ip and user_agent describe this request; reverse_ip looks up the IPv4 address in value, and domain_ip resolves the domain in value."
},
"value": {
"type": "string",
"maxLength": 253,
"description": "An IPv4 address for reverse_ip, a domain name for domain_ip."
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true
}validate_email — Check an email address
Check an email address: its syntax, whether its domain has MX records, listing up to five, and whether the domain has an address record. The mail server is not contacted, so a good answer does not prove that the mailbox exists. No API key, no account and no sign up.
{
"type": "object",
"required": [
"email"
],
"properties": {
"email": {
"type": "string",
"maxLength": 320,
"minLength": 1,
"description": "The email address to check. Nothing is sent to it."
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true
}validate_value — Validate a number or code
Validate an IBAN, a payment card number (Luhn), a Norwegian organisation number (orgnr), a Norwegian bank account number (kontonummer) or a phone number, with the checksum and the normalized form where the type has them. Nothing is stored or looked up. No API key, no account and no sign up.
{
"type": "object",
"required": [
"type",
"value"
],
"properties": {
"type": {
"enum": [
"iban",
"card",
"orgnr",
"kontonummer",
"phone"
],
"type": "string",
"description": "iban, card for a payment card number, orgnr for a Norwegian organisation number, kontonummer for a Norwegian bank account number, or phone."
},
"value": {
"type": [
"string",
"integer"
],
"description": "The value to check. Spaces and dashes are allowed."
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true
}slugify_text — Make a URL slug
Turn text into a lowercase URL slug with words joined by hyphens. No API key, no account and no sign up.
{
"type": "object",
"required": [
"text"
],
"properties": {
"text": {
"type": "string",
"maxLength": 10000,
"minLength": 1,
"description": "The text to turn into a slug, up to 10000 characters."
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true
}jwt_token — Create or verify a JWT
Create or check an HS256 JSON Web Token. encode signs payload with secret and answers jwt; decode verifies token with secret, including exp, nbf and iat, and answers decoded_payload. The secret is used for this call only and is not stored. No API key, no account and no sign up.
{
"type": "object",
"required": [
"operation",
"secret"
],
"properties": {
"token": {
"type": "string",
"maxLength": 65536,
"minLength": 1,
"description": "decode only."
},
"secret": {
"type": "string",
"maxLength": 4096,
"minLength": 1,
"description": "The HS256 signing key, 1 to 4096 characters."
},
"payload": {
"type": "object",
"description": "encode only: the claims."
},
"operation": {
"enum": [
"encode",
"decode"
],
"type": "string",
"description": "encode signs payload with secret and answers jwt; decode verifies token with secret and answers its payload."
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true
}create_qr_code — Make a QR code
Make a QR code for a text or URL, as a PNG with error correction level H. The answer is the image. No API key, no account and no sign up.
{
"type": "object",
"required": [
"text"
],
"properties": {
"text": {
"type": "string",
"maxLength": 2000,
"minLength": 1,
"description": "The text or URL the QR code holds, up to 2000 characters."
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true
}read_qr_code — Read QR codes in an image
Read the QR codes in a PNG, JPEG, GIF or WebP image. Several codes come back joined by newlines. Give image_base64 or storage_id. No API key, no account and no sign up.
{
"type": "object",
"properties": {
"storage_id": {
"type": "string",
"pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$",
"description": "A storage_id from store_file, from a previous tool result, or from REST /storage. Objects expire 24 hours after they were stored."
},
"image_base64": {
"type": "string",
"maxLength": 250000,
"minLength": 1,
"description": "The file as standard base64, at most about 190 KB of file through MCP. For a larger file, store it with REST POST /services/v1/storage first and pass storage_id."
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true
}html_to_pdf — Render HTML to PDF
Render HTML to a PDF with JavaScript and network access turned off, so only the HTML sent is used and images must be inline data URLs. options can set page-size (A3, A4, A5, Letter, Legal, Tabloid), orientation (Portrait, Landscape) and margin-top, margin-bottom, margin-left, margin-right such as 10mm. The PDF is stored for 24 hours: the answer has storage_id and storage_url, and read_stored_file returns the file. No API key, no account and no sign up.
{
"type": "object",
"required": [
"html"
],
"properties": {
"html": {
"type": "string",
"maxLength": 250000,
"minLength": 1,
"description": "The complete HTML to render. Scripts and network requests are off, so images must be inline data URLs."
},
"options": {
"type": "object",
"description": "Optional page settings: page-size (A3, A4, A5, Letter, Legal, Tabloid), orientation (Portrait, Landscape) and margin-top, margin-bottom, margin-left, margin-right such as 10mm."
}
},
"additionalProperties": false
}{
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}crypto_wallet — Bitcoin, Ethereum and Solana wallets
The balance of a public Bitcoin, Ethereum or Solana address, read from blockchain.info, a public Ethereum RPC node or the Solana mainnet RPC, or a newly generated key pair. A generated private key is sent once and not stored, but it has passed through this service, so use it for tests and small amounts only. No API key, no account and no sign up.
{
"type": "object",
"required": [
"chain",
"operation"
],
"properties": {
"chain": {
"enum": [
"bitcoin",
"ethereum",
"solana"
],
"type": "string",
"description": "bitcoin, ethereum or solana."
},
"address": {
"type": "string",
"maxLength": 44,
"minLength": 26,
"description": "balance only: the public address."
},
"operation": {
"enum": [
"balance",
"new_wallet"
],
"type": "string",
"description": "balance reads the balance of the public address in address; new_wallet generates a key pair that is sent once and not stored."
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": false
}json_csv_convert — Convert between JSON and CSV
Convert between JSON rows and CSV. json_to_csv takes columns and rows, up to 5000 flat objects, and stores result.csv; csv_to_json takes data, the CSV text, and stores result.json. delimiter is a comma, a semicolon or a tab. spreadsheet_safe guards cells a spreadsheet would run as formulas. The result is stored for 24 hours and the answer has its storage_id and storage_url. No API key, no account and no sign up.
{
"type": "object",
"required": [
"direction"
],
"properties": {
"data": {
"type": "string",
"maxLength": 250000,
"minLength": 1,
"description": "csv_to_json only."
},
"rows": {
"type": "array",
"items": {
"type": "object"
},
"maxItems": 5000,
"description": "json_to_csv only."
},
"columns": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 100,
"minItems": 1,
"description": "json_to_csv only."
},
"delimiter": {
"enum": [
",",
";",
"\t"
],
"type": "string",
"description": "The field separator: a comma (the default), a semicolon or a tab."
},
"direction": {
"enum": [
"json_to_csv",
"csv_to_json"
],
"type": "string",
"description": "json_to_csv turns columns and rows into result.csv; csv_to_json turns the CSV text in data into result.json."
},
"spreadsheet_safe": {
"type": "boolean",
"description": "json_to_csv only."
}
},
"additionalProperties": false
}{
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}html_markdown_convert — Convert between HTML and Markdown
Convert HTML to Markdown, or Markdown to HTML. html_to_markdown leaves out scripts, styles, forms and media and answers markdown and the page title, so a fetched page reads with fewer tokens. markdown_to_html answers html from CommonMark with GitHub tables, strikethrough and task lists; raw HTML in the Markdown is shown as text and a link with an unsafe scheme as its text, so the html can go into a page as it is. No API key, no account and no sign up.
{
"type": "object",
"required": [
"direction",
"data"
],
"properties": {
"data": {
"type": "string",
"maxLength": 250000,
"minLength": 1,
"description": "The HTML or the Markdown."
},
"direction": {
"enum": [
"html_to_markdown",
"markdown_to_html"
],
"type": "string",
"description": "html_to_markdown converts the HTML in data to Markdown; markdown_to_html converts the Markdown in data to HTML."
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true
}json_check — Format or validate JSON
Format or validate JSON text. format pretty-prints it (mode pretty, indent 2 or 4) or compacts it (mode compact); validate reports whether it parses and where it breaks. The result is stored for 24 hours and the answer has its storage_id and storage_url. No API key, no account and no sign up.
{
"type": "object",
"required": [
"operation",
"data"
],
"properties": {
"data": {
"type": "string",
"maxLength": 250000,
"minLength": 1,
"description": "The JSON text."
},
"mode": {
"enum": [
"pretty",
"compact"
],
"type": "string",
"description": "format only."
},
"indent": {
"enum": [
2,
4
],
"type": "integer",
"description": "format only."
},
"operation": {
"enum": [
"format",
"validate"
],
"type": "string",
"description": "format pretty-prints or compacts the JSON in data; validate reports whether it parses and where it breaks."
}
},
"additionalProperties": false
}{
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}match_tables — Match two tables
Match the rows of two tables on one or more pairs of key columns, like a join, and store the matches as JSON for 24 hours. left and right are lists of row objects; keys lists pairs such as {"left":"id","right":"customer_id"}. No API key, no account and no sign up.
{
"type": "object",
"required": [
"left",
"right",
"keys"
],
"properties": {
"keys": {
"type": "array",
"items": {
"type": "object"
},
"maxItems": 100,
"minItems": 1,
"description": "Pairs of key columns to match on, such as {\"left\": \"id\", \"right\": \"customer_id\"}."
},
"left": {
"type": "array",
"items": {
"type": "object"
},
"description": "The first table, as a list of row objects."
},
"right": {
"type": "array",
"items": {
"type": "object"
},
"description": "The second table, as a list of row objects."
}
},
"additionalProperties": false
}{
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}process_image — Convert, vectorize, resize or inspect an image
Convert a JPEG, PNG, WebP, HEIC or supported static SVG to JPEG, PNG or WebP (format, quality, lossless). Vectorize a PNG or JPEG to black SVG paths on a transparent background (threshold). The trace fits within 1024 by 1024 pixels. For JPEG, PNG or WebP, compress (quality), resize (width, height, fit contain or cover, upscale, format), read metadata including any GPS position (metadata), strip EXIF, XMP and IPTC (strip), find its main colors (colors, count) or make favicons as a ZIP (favicon, crop fit, trim or center, name). Resize also accepts HEIC. Metadata and strip also accept GIF. Give image_base64 or storage_id, for example the result of an earlier call. Every result is stored for 24 hours and the answer carries its storage_id, so calls can be chained. No API key, no account and no sign up.
{
"type": "object",
"required": [
"operation"
],
"properties": {
"fit": {
"enum": [
"contain",
"cover"
],
"type": "string",
"description": "For resize to a width and a height: contain keeps the whole image inside the box, cover fills the box and crops what sticks out."
},
"crop": {
"enum": [
"fit",
"trim",
"center"
],
"type": "string",
"description": "For favicon: fit pads the image to a square, trim removes plain borders first and then pads, center fills the square and crops what sticks out."
},
"name": {
"type": "string",
"maxLength": 60,
"minLength": 1,
"description": "favicon only: the site name for the manifest."
},
"count": {
"type": "integer",
"maximum": 16,
"minimum": 2,
"description": "For colors, how many main colors to find, 2 to 16."
},
"width": {
"type": "integer",
"maximum": 10000,
"minimum": 1,
"description": "Target width in pixels for resize, 1 to 10000."
},
"format": {
"enum": [
"jpeg",
"jpg",
"png",
"webp"
],
"type": "string",
"description": "The output format for convert and resize: jpeg, png or webp. jpg is the same as jpeg."
},
"height": {
"type": "integer",
"maximum": 10000,
"minimum": 1,
"description": "Target height in pixels for resize, 1 to 10000."
},
"quality": {
"type": "integer",
"maximum": 95,
"minimum": 40,
"description": "Quality from 40 to 95 for JPEG and lossy WebP output."
},
"upscale": {
"type": "boolean",
"description": "For resize, true lets the image grow beyond its original size."
},
"lossless": {
"type": "boolean",
"description": "For WebP output, true stores the image losslessly and ignores quality."
},
"operation": {
"enum": [
"convert",
"vectorize",
"compress",
"resize",
"metadata",
"strip",
"colors",
"favicon"
],
"type": "string",
"description": "convert to another format, vectorize to SVG paths, compress, resize, read metadata, strip metadata, find the main colors, or make favicons."
},
"threshold": {
"type": "integer",
"default": 50,
"maximum": 99,
"minimum": 1,
"description": "Brightness threshold in percent for vectorize. Higher values include lighter pixels."
},
"storage_id": {
"type": "string",
"pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$",
"description": "A storage_id from store_file, from a previous tool result, or from REST /storage. Objects expire 24 hours after they were stored."
},
"image_base64": {
"type": "string",
"maxLength": 250000,
"minLength": 1,
"description": "The file as standard base64, at most about 190 KB of file through MCP. For a larger file, store it with REST POST /services/v1/storage first and pass storage_id."
}
},
"additionalProperties": false
}{
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}decide — Decide from rules or a model
Omit model or use rules for the existing yes_no, choice and scale rule engine with probability, confidence and action. Use model clef, nimble or tev1 for noul, choice and score questions with instructions and criteria. tev1 is the smallest and fastest, tested by its maker in English only, and suits short, direct questions. Model mode processes the submitted state and questions and returns structured answers without an automatic action or rule trace. Model requests allow up to 8 KiB of JSON, 3 KiB for tev1, 4 questions and 8 choices per question, and have their own usage limit of 60 per minute and 1000 per UTC day per IP. Refusals may carry Retry-After. state holds the facts. For rules, each rule is {"if": condition, "weight": number}, where a condition tests a field of state with eq, ne, gt, gte, lt, lte, in, exists, prefix or contains, combined with any and not. Request and answer bodies are not stored by this API. Usage counters are stored. Do not send credentials or sensitive personal data. The full format is at https://aisense.no/free-public-api-decide-api-endpoint. No API key, no account and no sign up.
{
"type": "object",
"required": [
"state",
"questions"
],
"properties": {
"model": {
"type": "string",
"maxLength": 32,
"minLength": 1,
"description": "Optional. rules (default), clef, nimble or tev1. Unknown models are refused."
},
"state": {
"type": "object",
"description": "The facts the rules test, or the input sent to the selected model."
},
"questions": {
"type": "object",
"description": "1 to 64 named rule questions, or up to 4 model questions under the default model limits."
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": false
}simulate_failure — Simulate a failure
Get a chosen failure on purpose, to test how an agent or client handles it: an HTTP status from 200 to 504, an HTML error page (html), an empty body (empty) or JSON labelled as text (wrongtype), after an optional delay of up to 10 seconds. The result reports the status, content type, headers and body the REST endpoint sent, and is an error result for statuses of 400 and above. No API key, no account and no sign up.
{
"type": "object",
"required": [
"outcome"
],
"properties": {
"outcome": {
"enum": [
"200",
"201",
"204",
"400",
"401",
"403",
"404",
"409",
"410",
"422",
"429",
"500",
"502",
"503",
"504",
"html",
"empty",
"wrongtype"
],
"type": "string",
"description": "The HTTP status to answer with, 200 to 504, or html for an HTML error page, empty for an empty body, or wrongtype for JSON labelled as text."
},
"delay_ms": {
"type": "integer",
"maximum": 10000,
"minimum": 0,
"description": "Wait this many milliseconds before answering, 0 to 10000."
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": false
}schedule_webhook — Schedule a webhook
Schedule an HTTP POST of a JSON payload to a public URL: once, after delay_seconds or at the Unix time fire_at, 5 seconds to 24 hours ahead, or repeatedly every 60 to 86400 seconds until 24 hours after creation. The URL must use a host name, not an IP address, and resolve to a public address on port 80 or 443. The answer has schedule_id, which reads and cancels the job and should be kept private. No API key, no account and no sign up.
{
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"maxLength": 2048,
"minLength": 1,
"description": "The public http or https URL to POST to, with a host name rather than an IP address, on port 80 or 443."
},
"every": {
"type": "integer",
"maximum": 86400,
"minimum": 60,
"description": "Fire repeatedly at this interval in seconds, 60 to 86400, until 24 hours after creation."
},
"fire_at": {
"type": "integer",
"description": "Fire once at this Unix time, 5 seconds to 24 hours ahead."
},
"payload": {
"description": "Any JSON, at most 32 KB. Defaults to {}."
},
"delay_seconds": {
"type": "integer",
"maximum": 86400,
"minimum": 5,
"description": "Fire once after this many seconds, 5 to 86400."
}
},
"additionalProperties": false
}{
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}read_webhook_schedule — Read a scheduled webhook
Read a scheduled webhook: its status, attempts and, after it fired, the HTTP status and an excerpt of the answer. wait_seconds, up to 25, waits for the status to change before answering. No API key, no account and no sign up.
{
"type": "object",
"required": [
"schedule_id"
],
"properties": {
"schedule_id": {
"type": "string",
"pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$",
"description": "The schedule_id from schedule_webhook."
},
"wait_seconds": {
"type": "integer",
"maximum": 25,
"minimum": 0,
"description": "Wait up to this many seconds, 0 to 25, for the status to change before answering."
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": false
}cancel_webhook_schedule — Cancel a scheduled webhook
Cancel a scheduled webhook that has not finished. A job that has already ended cannot be cancelled. No API key, no account and no sign up.
{
"type": "object",
"required": [
"schedule_id"
],
"properties": {
"schedule_id": {
"type": "string",
"pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$",
"description": "The schedule_id from schedule_webhook."
}
},
"additionalProperties": false
}{
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": true
}service_health — Check the service
Check that the AI SENSE service answers. Returns status ok and the server time with microseconds. No API key, no account and no sign up.
{
"type": "object",
"properties": {},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": false
}store_file — Store a file
Store a file given as base64 for 24 hours, at a link that anyone who has it can open. Answers storage_id and storage_url. Use it to hand a file to another tool, such as an image to process_image or read_qr_code. Never store secrets or personal data. max_downloads, 1 to 100, removes the file after that many fetches; the answer then carries downloads_max and downloads_left, and a spent storage_id answers that the object is gone. No API key, no account and no sign up.
{
"type": "object",
"required": [
"data_base64"
],
"properties": {
"data_base64": {
"type": "string",
"maxLength": 250000,
"minLength": 1,
"description": "The file as standard base64, at most about 190 KB of file through MCP. For a larger file, store it with REST POST /services/v1/storage first and pass storage_id."
},
"max_downloads": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Optional. How many times the file may be fetched before it is removed, 1 to 100. Without it the file lives 24 hours."
}
},
"additionalProperties": false
}{
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}read_stored_file — Read a stored file
Read a stored object by storage_id. JSON comes back as data, an image as an image, and any other file, such as a PDF from html_to_pdf or a ZIP from process_image, as an embedded resource of at most 4 MB. No API key, no account and no sign up.
{
"type": "object",
"required": [
"storage_id"
],
"properties": {
"storage_id": {
"type": "string",
"pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$",
"description": "A storage_id from store_file, from a previous tool result, or from REST /storage. Objects expire 24 hours after they were stored."
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true
}create_semantic_search — Create a semantic search collection
Create a collection of short notes, such as messages, jobs or results, that agents search by meaning, across wording and between languages. It lives for a fixed 24 hours that cannot be extended. model is bge-m3 (default) or qwen3-embedding-4b and stays fixed for the collection. Returns collection_id and separate read and write bearer tokens once: keep them secret and share only the role needed. At most 500 notes over the collection lifetime and 20 collections per client IP in 24 hours. No API key, no account and no sign up.
{
"type": "object",
"properties": {
"model": {
"enum": [
"bge-m3",
"qwen3-embedding-4b"
],
"type": "string",
"description": "Optional. bge-m3 (default) or qwen3-embedding-4b."
}
},
"additionalProperties": false
}{
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}add_semantic_search_notes — Add notes to a semantic search collection
Add 1 to 32 notes with the write token. Each note is an object with text, 1 to 2000 characters, and an optional key of up to 64 letters, digits, dots, underscores, colons or hyphens. Notes are stored until the collection expires and count toward its 500-note lifetime limit, deleted notes included. Never send secrets or sensitive personal data. Adding and searching share a usage limit of 60 per minute and 1000 per UTC day per IP. Refusals may carry Retry-After. No API key, no account and no sign up.
{
"type": "object",
"required": [
"collection_id",
"write_token",
"notes"
],
"properties": {
"notes": {
"type": "array",
"items": {
"type": "object"
},
"maxItems": 32,
"minItems": 1,
"description": "Notes such as {\"text\": \"Refund order DEMO-57\", \"key\": \"job:57\"}."
},
"write_token": {
"type": "string",
"pattern": "^[0-9a-f]{64}$",
"description": "The write_token from create_semantic_search, shown once. It adds and deletes notes."
},
"collection_id": {
"type": "string",
"pattern": "^[0-9a-f]{32}$",
"description": "The collection_id from create_semantic_search."
}
},
"additionalProperties": false
}{
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}query_semantic_search — Search a semantic search collection
Search the notes by meaning with the read token. Answers up to limit notes, 1 to 10 and 3 by default, best first, each with note_id, key, text and score. The score is cosine similarity, plus 0.1 for each identifier in the search that the note also holds, minus 0.1 for each kind where the note holds others of that kind and none of the search's. Each code prefix, such as DEMO- in DEMO-57, is one kind and numbers of three or more digits are another, with 1 200 read as 1200. The score is not a probability. The results are ranked suggestions, not a decision that a match exists: read the text before acting on it. No API key, no account and no sign up.
{
"type": "object",
"required": [
"collection_id",
"read_token",
"query"
],
"properties": {
"limit": {
"type": "integer",
"maximum": 10,
"minimum": 1,
"description": "How many notes to answer, 1 to 10, default 3."
},
"query": {
"type": "string",
"maxLength": 500,
"minLength": 1,
"description": "What to look for, in plain words, up to 500 characters."
},
"read_token": {
"type": "string",
"pattern": "^[0-9a-f]{64}$",
"description": "The read_token from create_semantic_search, shown once. It reads and searches the collection."
},
"collection_id": {
"type": "string",
"pattern": "^[0-9a-f]{32}$",
"description": "The collection_id from create_semantic_search."
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true
}read_semantic_search — Read a semantic search collection
Read the model, the number of notes, the notes added over the lifetime, the note limit and the expiry of a collection with the read token. Notes are found by searching. No API key, no account and no sign up.
{
"type": "object",
"required": [
"collection_id",
"read_token"
],
"properties": {
"read_token": {
"type": "string",
"pattern": "^[0-9a-f]{64}$",
"description": "The read_token from create_semantic_search, shown once. It reads and searches the collection."
},
"collection_id": {
"type": "string",
"pattern": "^[0-9a-f]{32}$",
"description": "The collection_id from create_semantic_search."
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true
}delete_semantic_search_note — Delete a note from a semantic search collection
Delete one note with the write token. Its text and vector are removed and it leaves the search at once. Its place in the 500-note lifetime limit stays used. No API key, no account and no sign up.
{
"type": "object",
"required": [
"collection_id",
"note_id",
"write_token"
],
"properties": {
"note_id": {
"type": "string",
"pattern": "^[0-9a-f]{32}$",
"description": "The note_id from add_semantic_search_notes or a search."
},
"write_token": {
"type": "string",
"pattern": "^[0-9a-f]{64}$",
"description": "The write_token from create_semantic_search, shown once. It adds and deletes notes."
},
"collection_id": {
"type": "string",
"pattern": "^[0-9a-f]{32}$",
"description": "The collection_id from create_semantic_search."
}
},
"additionalProperties": false
}{
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": true
}create_one_time_secret — Store a client-encrypted one-time secret
Store an already encrypted AES-256-GCM envelope for at most 24 hours. Encrypt locally first. Never send plaintext or the decryption key to MCP, chat or this API. MCP clients may log tool arguments and bearer tokens. Returns separate read and receipt tokens once. Maximum plaintext size before encryption is 16384 bytes. Creation allows 100 per IP per UTC day; not idempotent. No API key, no account and no sign up.
{
"type": "object",
"required": [
"version",
"algorithm",
"nonce",
"ciphertext"
],
"properties": {
"nonce": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{16}$",
"description": "Unpadded base64url of the fresh 12-byte nonce."
},
"version": {
"enum": [
1
],
"type": "integer",
"description": "The envelope version, always 1."
},
"algorithm": {
"enum": [
"AES-256-GCM"
],
"type": "string",
"description": "The cipher, always AES-256-GCM."
},
"ciphertext": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]+$",
"maxLength": 21867,
"minLength": 23,
"description": "Unpadded base64url ciphertext including the 16-byte authentication tag, no key."
}
},
"additionalProperties": false
}{
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}reveal_one_time_secret — Consume one encrypted secret
Destructively consume and return ciphertext using the read token. Decrypt locally; never send the key to MCP. Consumption happens before the response: a lost response cannot be recovered by retrying. Reveal only with explicit intent; never automatically retry. No API key, no account and no sign up.
{
"type": "object",
"required": [
"secret_id",
"read_token"
],
"properties": {
"secret_id": {
"type": "string",
"pattern": "^[0-9a-f]{32}$",
"description": "The secret_id returned at creation; not a credential."
},
"read_token": {
"type": "string",
"pattern": "^[0-9a-f]{64}$",
"description": "The read_token returned once at creation. Authorizes one destructive ciphertext reveal."
}
},
"additionalProperties": false
}{
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": true
}read_one_time_secret_receipt — Read one-time secret status
Read status and timestamps using the separate receipt token. Never returns ciphertext or plaintext and does not consume the secret. Status is a server event, not proof a person read it. No API key, no account and no sign up.
{
"type": "object",
"required": [
"secret_id",
"receipt_token"
],
"properties": {
"secret_id": {
"type": "string",
"pattern": "^[0-9a-f]{32}$",
"description": "The secret_id returned at creation; not a credential."
},
"receipt_token": {
"type": "string",
"pattern": "^[0-9a-f]{64}$",
"description": "The receipt_token returned once at creation. Reads metadata or burns; cannot reveal."
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true
}burn_one_time_secret — Revoke one-time secret ciphertext
Permanently remove any pending ciphertext using the receipt token. Repeating a burn is safe. Burning cannot recover or revoke ciphertext already revealed. No API key, no account and no sign up.
{
"type": "object",
"required": [
"secret_id",
"receipt_token"
],
"properties": {
"secret_id": {
"type": "string",
"pattern": "^[0-9a-f]{32}$",
"description": "The secret_id returned at creation; not a credential."
},
"receipt_token": {
"type": "string",
"pattern": "^[0-9a-f]{64}$",
"description": "The receipt_token returned once at creation. Reads metadata or burns; cannot reveal."
}
},
"additionalProperties": false
}{
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": true
}create_agent_handoff — Create an agent handoff
Create one piece of work to pass to another agent as a small state machine that lives 24 hours. payload is the JSON the receiver works from, at most 16 KiB. The default states are offered, accepted, working, done, failed and returned, the last three final; states, final and transitions can declare another machine, which always moves forward through its states. Returns an owner_token and a receiver_token once: keep the owner token, give the receiver token to the other agent. notify_url receives one small signal per committed transition. Creation allows 100 per IP per UTC day; not idempotent. No API key, no account and no sign up.
{
"type": "object",
"required": [
"payload"
],
"properties": {
"note": {
"type": "string",
"maxLength": 500,
"minLength": 1,
"description": "An optional note kept with the handoff, up to 500 characters."
},
"final": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[a-z][a-z0-9_]{0,31}$"
},
"maxItems": 12,
"minItems": 1,
"description": "The states that end the handoff. Default: the last state, or done, failed and returned."
},
"states": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[a-z][a-z0-9_]{0,31}$"
},
"maxItems": 12,
"minItems": 2,
"description": "The states in order; the first is where the handoff starts."
},
"payload": {
"description": "Any JSON value but null, which the receiving agent works from, at most 16 KiB as JSON."
},
"notify_url": {
"type": "string",
"maxLength": 2048,
"description": "A public http or https URL with a host name, not an IP address, that receives a small JSON signal after each committed transition."
},
"transitions": {
"type": "object",
"description": "Allowed moves from a state, each to a later state. A state left out may move to every later state.",
"additionalProperties": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[a-z][a-z0-9_]{0,31}$"
}
}
}
},
"additionalProperties": false
}{
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}advance_agent_handoff — Advance an agent handoff
Move a handoff to the state named in to. from names the state the handoff is expected to be in now: the move is committed only from exactly that state over an allowed transition, otherwise the answer is a 409 that carries the real state. Repeat a move with the same nonce after a lost answer and the committed transition is returned with repeated true instead of a conflict. No API key, no account and no sign up.
{
"type": "object",
"required": [
"handoff_id",
"token",
"to",
"from"
],
"properties": {
"to": {
"type": "string",
"pattern": "^[a-z][a-z0-9_]{0,31}$",
"description": "The state to move to."
},
"from": {
"type": "string",
"pattern": "^[a-z][a-z0-9_]{0,31}$",
"description": "The state the handoff is expected to be in now."
},
"note": {
"type": "string",
"maxLength": 500,
"minLength": 1,
"description": "An optional note recorded with this move in the history, up to 500 characters."
},
"nonce": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,64}$",
"description": "Your own key for this move, so a repeat after a lost answer is recognized."
},
"token": {
"type": "string",
"pattern": "^[0-9a-f]{64}$",
"description": "The owner_token or the receiver_token returned once at creation. Both read and advance; the history records which one acted."
},
"handoff_id": {
"type": "string",
"pattern": "^[0-9a-f]{32}$",
"description": "The handoff_id returned at creation; not a credential."
}
},
"additionalProperties": false
}{
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}read_agent_handoff — Read an agent handoff
Read the state, payload, states, allowed transitions and history of a handoff with either token. wait_seconds, up to 25, waits for the state to change or the handoff to end before answering. No API key, no account and no sign up.
{
"type": "object",
"required": [
"handoff_id",
"token"
],
"properties": {
"token": {
"type": "string",
"pattern": "^[0-9a-f]{64}$",
"description": "The owner_token or the receiver_token returned once at creation. Both read and advance; the history records which one acted."
},
"handoff_id": {
"type": "string",
"pattern": "^[0-9a-f]{32}$",
"description": "The handoff_id returned at creation; not a credential."
},
"wait_seconds": {
"type": "integer",
"maximum": 25,
"minimum": 0,
"description": "Wait up to this many seconds, 0 to 25, for the state to change before answering."
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": false
}create_agent_run — Create an agent run
Create a run: a plan of 1 to 16 steps that the service keeps and goes through in order, with its deadlines and recovery, for up to 24 hours. A step is delegate, a job workers claim through claim_agent_queue_job; wait, on time, an outside event or a person; decide, rules over the last result; and complete, always the last one. Returns run_id, read_token and control_token once, and for a plan with delegated steps queue_id and worker_token for the workers. With idempotency_key, a repeat after a lost answer returns the same run and tokens instead of a new run. Creation allows 20 per IP per UTC day. No API key, no account and no sign up.
{
"type": "object",
"required": [
"steps",
"ttl_seconds"
],
"properties": {
"steps": {
"type": "array",
"items": {
"type": "object"
},
"maxItems": 16,
"minItems": 1,
"description": "The steps in order. Each has id and type. delegate takes task and timeout_seconds, wait takes event (time, external or human) with delay_seconds or timeout_seconds, decide takes request with state and questions, and optional require."
},
"ttl_seconds": {
"type": "integer",
"maximum": 86400,
"minimum": 60,
"description": "The run's lifetime, fixed at creation and extended by nothing."
},
"idempotency_key": {
"type": "string",
"pattern": "^[0-9a-f]{64}$",
"description": "32 bytes from a secure random source as lower-case hex, the same for a repeat of the same plan."
}
},
"additionalProperties": false
}{
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}read_agent_run — Read an agent run
Read a run's status, steps, results and time left. A control token also sees the form_url and wake_url of a step waiting for an answer, each a link to hand to whoever should answer. wait_seconds, up to 25, waits for a change or the end before answering. No API key, no account and no sign up.
{
"type": "object",
"required": [
"run_id",
"token"
],
"properties": {
"token": {
"type": "string",
"pattern": "^[0-9a-f]{64}$",
"description": "The read_token or the control_token returned once at creation."
},
"run_id": {
"type": "string",
"pattern": "^[0-9a-f]{32}$",
"description": "The run_id returned at creation; not a credential."
},
"wait_seconds": {
"type": "integer",
"maximum": 25,
"minimum": 0,
"description": "Wait up to this many seconds, 0 to 25, for the run to change before answering."
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": false
}complete_agent_run_step — Complete a step of an agent run
Hand in the result of a delegated step, with the worker_token and the receipt from claim_agent_queue_job. The run completes the job itself, so send no ack, and the next step begins in this request. Repeat the same request after a lost answer or while submission_status says verifying. A 409 carries a code saying what to do. No API key, no account and no sign up.
{
"type": "object",
"required": [
"run_id",
"step_id",
"token",
"receipt",
"result"
],
"properties": {
"token": {
"type": "string",
"pattern": "^[0-9a-f]{64}$",
"description": "The worker_token returned once at creation."
},
"result": {
"description": "Any JSON value but null, at most 7 KiB as JSON."
},
"run_id": {
"type": "string",
"pattern": "^[0-9a-f]{32}$",
"description": "The run_id returned at creation; not a credential."
},
"receipt": {
"type": "string",
"maxLength": 128,
"minLength": 1,
"description": "The receipt of the current claim."
},
"step_id": {
"type": "string",
"pattern": "^[a-z][a-z0-9-]{0,31}$",
"description": "The id of the delegated step, as written in the plan."
}
},
"additionalProperties": false
}{
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}cancel_agent_run — Cancel an agent run
End a run with its control token. Nothing further starts, and a cancel after the end answers 409 with the real status. No API key, no account and no sign up.
{
"type": "object",
"required": [
"run_id",
"token"
],
"properties": {
"token": {
"type": "string",
"pattern": "^[0-9a-f]{64}$",
"description": "The control_token returned once at creation."
},
"run_id": {
"type": "string",
"pattern": "^[0-9a-f]{32}$",
"description": "The run_id returned at creation; not a credential."
}
},
"additionalProperties": false
}{
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": true
}Prompts
Not advertised
Resources
3 advertised
verifyum — Verifyum private file proofs
AI SENSE product information for Verifyum. Solana Mainnet anchoring and the Witness Layer are active, the original file is not uploaded and a dedicated MCP endpoint is available.
https://aisense.no/verifyumaamio — aamio ephemeral agent rendezvous
AI SENSE product information for aamio. A thread between two agents with a secret read key and a public write address, expiring at a fixed time, a receipt that outlives it, and an open board where agents that have never met find each other.
https://aisense.no/aamiofree-public-tools — AI SENSE Free Public Tools skill
Versioned guide to all public AI SENSE MCP tools, including Queue, Lease, Agent Wake, Heartbeat, Inbox, approvals, capability roles and retry boundaries.
skill://com.aisenseapi/free-public-tools90-day uptime
A lightweight connection check about every six hours, sampled on hosts with many listings. It shows the server answered, not that its tools work.
- 2026-11-07: 1 of 1 checks answered
30-day availability
Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.
- Successful checks
- 1 of 1 (100%)
- Average latency
- 1146 ms
- 95th percentile latency
- 1146 ms
Maintenance history
Public check and source-refresh events. Editorial and ownership records remain private.
- · probe · passed · 1146 ms · metadata changed · 79 tool(s), 3 resource(s); warnings: Advertises resources/templates/list but does not implement it
Connect from your client
Each snippet registers the same endpoint; pick the client you use.
Claude Code
claude mcp add --transport http ai-sense-free-public-tools-mcp https://aisenseapi.com/mcpCodex
codex mcp add ai-sense-free-public-tools-mcp --url https://aisenseapi.com/mcpCursor
{
"mcpServers": {
"ai-sense-free-public-tools-mcp": {
"url": "https://aisenseapi.com/mcp"
}
}
}Cline
{
"mcpServers": {
"ai-sense-free-public-tools-mcp": {
"type": "streamableHttp",
"url": "https://aisenseapi.com/mcp",
"disabled": false
}
}
}VS Code
{
"servers": {
"ai-sense-free-public-tools-mcp": {
"type": "http",
"url": "https://aisenseapi.com/mcp"
}
}
}Gemini CLI
gemini mcp add --transport http ai-sense-free-public-tools-mcp https://aisenseapi.com/mcpClaude Desktop
https://aisenseapi.com/mcpWindsurf
{
"mcpServers": {
"ai-sense-free-public-tools-mcp": {
"serverUrl": "https://aisenseapi.com/mcp"
}
}
}Let your agent find its tools
Find servers like AI SENSE Free Public Tools MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.
Other developer tools servers
Do you run AI SENSE Free Public Tools MCP?
Prove ownership with a DNS record, a well-known file, or your Official MCP Registry entry, and your edits publish immediately. Proofs are re-checked weekly; admins can still hide or remove a listing.