AI SENSE Free Public Tools
79 public tools: agent workflows, audio data transfer, semantic search, queues and webhooks.
| Endpoint | https://aisenseapi.com/mcp (streamable-http) |
|---|---|
| Registry version | 1.18.0 |
| Now | 79 tools · grade D (54) · pin ts_b8bdf92a64eb80e6eaf83ae4fb7e99d3 · protocol 2025-06-18 |
| First / last listed | 2026-11-07 01:57 UTC / 2026-11-07 01:57 UTC |
| Grade over time | 2026-11-07: D (54), 79 tools |
Is this your server? Own a server? ToolFit hosted watch re-checks it every 24 h ($0.25 per 30 days) or 6 h ($0.60) and sends you an HMAC-signed webhook when its tools or grade change: POST https://api.youraitools.co/toolfit/v1/watch. To opt out, see About & opt-out.
Tools: get_current_time generate_uuid shorten_url store_temporary_data read_temporary_data create_webhook_capture read_webhook_capture create_human_approval read_human_approval create_agent_wake create_heartbeat read_heartbeat ping_heartbeat create_lease_namespace acquire_lease renew_lease release_lease complete_lease create_agent_inbox read_agent_inbox create_agent_queue read_agent_queue enqueue_agent_queue_job read_agent_queue_job claim_agent_queue_job ack_agent_queue_job release_agent_queue_job renew_agent_queue_job create_dns_name read_dns_name update_dns_name delete_dns_name encode_data encode_audio decode_audio hash_data verify_hash generate_random time_formats convert_timestamp list_timezones lookup_network validate_email validate_value slugify_text jwt_token create_qr_code read_qr_code html_to_pdf crypto_wallet json_csv_convert html_markdown_convert json_check match_tables process_image decide simulate_failure schedule_webhook read_webhook_schedule cancel_webhook_schedule service_health store_file read_stored_file create_semantic_search add_semantic_search_notes query_semantic_search read_semantic_search delete_semantic_search_note create_one_time_secret reveal_one_time_secret read_one_time_secret_receipt burn_one_time_secret create_agent_handoff advance_agent_handoff read_agent_handoff create_agent_run read_agent_run complete_agent_run_step cancel_agent_run
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 params: timezone |
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. params: none |
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. params: long_url* |
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 val params: data*, max_downloads |
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 params: storage_id* |
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 r params: notify_url |
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 a params: capture_id*, wait_seconds |
create_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, accou params: title*, description, options, allow_note, respondents, notify_url |
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. params: action_id*, wait_seconds |
create_agent_wake | 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. params: event_type*, timeout_seconds, delay_seconds, wake_at, title, description, options, allow_note |
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 params: expect_every_seconds*, grace_seconds*, on_miss* |
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. params: heartbeat_id* |
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. params: heartbeat_id* |
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. params: none |
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. params: namespace, key*, ttl_seconds, fingerprint |
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. params: namespace, key*, owner_token*, ttl_seconds |
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. params: namespace, key*, owner_token* |
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. params: namespace, key*, owner_token*, result* |
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 params: none |
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 params: inbox_id*, wait_seconds |
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 params: none |
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. params: queue_id*, read_token* |
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. params: queue_id*, write_token*, job_key*, payload* |
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. params: queue_id*, read_token*, job_id* |
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. params: queue_id*, worker_token*, visibility_timeout |
ack_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. params: queue_id*, worker_token*, job_id*, receipt* |
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. params: queue_id*, worker_token*, job_id*, receipt* |
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. params: queue_id*, worker_token*, job_id*, receipt*, visibility_timeout |
create_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 d params: ip*, ttl |
read_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. params: slug* |
update_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. params: slug*, dns_token*, ip, ttl |
delete_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 th params: slug*, dns_token* |
encode_data | 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, n params: operation*, format*, data* |
encode_audio | 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 encodi params: data*, input_encoding, mode |
decode_audio | 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 params: storage_id*, mode |
hash_data | 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 params: algorithm*, data* |
verify_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 algorit params: data*, hash*, algorithm |
generate_random | 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. params: kind*, from, to, length, groups |
time_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. params: offset |
convert_timestamp | 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. params: value*, offset |
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. params: offset |
lookup_network | 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. params: kind*, value |
validate_email | 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. params: email* |
validate_value | 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. params: type*, value* |
slugify_text | Turn text into a lowercase URL slug with words joined by hyphens. No API key, no account and no sign up. params: text* |
jwt_token | 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. params: operation*, secret*, payload, token |
create_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. params: text* |
read_qr_code | 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. params: image_base64, storage_id |
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 params: html*, options |
crypto_wallet | 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. params: chain*, operation*, address |
json_csv_convert | 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 params: direction*, columns, rows, data, delimiter, spreadsheet_safe |
html_markdown_convert | 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 params: direction*, data* |
json_check | 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. params: operation*, data*, mode, indent |
match_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. params: left*, right*, keys* |
process_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 EX params: operation*, image_base64, storage_id, format, quality, threshold, lossless, width, height, fit, upscale, count, crop, name |
decide | 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 structur params: model, state*, questions* |
simulate_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 accou params: outcome*, delay_ms |
schedule_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. params: url*, delay_seconds, fire_at, every, payload |
read_webhook_schedule | 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. params: schedule_id*, wait_seconds |
cancel_webhook_schedule | 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. params: schedule_id* |
service_health | 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. params: none |
store_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 an params: data_base64*, max_downloads |
read_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. params: storage_id* |
create_semantic_search | 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 params: model |
add_semantic_search_notes | 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 min params: collection_id*, write_token*, notes* |
query_semantic_search | 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 kin params: collection_id*, read_token*, query*, limit |
read_semantic_search | 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. params: collection_id*, read_token* |
delete_semantic_search_note | 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. params: collection_id*, note_id*, write_token* |
create_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 a params: version*, algorithm*, nonce*, ciphertext* |
reveal_one_time_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. params: secret_id*, read_token* |
read_one_time_secret_receipt | 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. params: secret_id*, receipt_token* |
burn_one_time_secret | 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. params: secret_id*, receipt_token* |
create_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 params: payload*, states, final, transitions, note, notify_url |
advance_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 an params: handoff_id*, token*, to*, from*, note, nonce |
read_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. params: handoff_id*, token*, wait_seconds |
create_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 d params: steps*, ttl_seconds*, idempotency_key |
read_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. params: run_id*, token*, wait_seconds |
complete_agent_run_step | 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. params: run_id*, step_id*, token*, receipt*, result* |
cancel_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. params: run_id*, token* |
Entries describe changes in tool definitions. They are not statements about a server, its quality or its author. The grade measures how the tool definitions fit model providers (token cost, schema compatibility, confusable names) as scored by the ToolFit engine at the time of the listing. JSON: append .json. Opt-out: how or hello@youraitools.co.