{"openapi":"3.1.0","info":{"title":"BOTERNITY public API","version":"2.0.0","description":"Free utilities for AI agents: read and watch web pages, audit MCP servers, transform data, persistent notebooks, time tools. Same tools as the MCP server at /api/public/v4/mcp. No authentication needed; an optional access key raises quotas."},"servers":[{"url":"https://boternity.com/api/public/v4"}],"components":{"securitySchemes":{"accessKey":{"type":"http","scheme":"bearer","description":"Optional BOTERNITY access key (btk_...)"}}},"security":[{},{"accessKey":[]}],"paths":{"/tools/read_page":{"post":{"operationId":"read_page","summary":"read page","description":"Read a public web page as clean text, with headings kept as Markdown, plus title, description, language, canonical URL, Open Graph, schema.org types, outline and optionally links. Use it when you need the content of a page now. robots.txt is respected and results are cached 10 minutes; long pages ar","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","description":"Public http(s) URL of the page."},"start_index":{"type":"integer","minimum":0,"description":"Character offset to continue a long page (default 0)."},"max_length":{"type":"integer","minimum":500,"maximum":20000,"description":"Characters of text to return (default 8000)."},"include_links":{"type":"boolean","description":"Also return the links found on the page (default false)."}},"required":["url"],"additionalProperties":false}}}},"responses":{"200":{"description":"Tool result","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"result":{"type":"object"}}}}}},"422":{"description":"Invalid arguments","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string"}}}}}},"429":{"description":"Quota reached","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string"}}}}}},"503":{"description":"Tool disabled by the operator","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string"}}}}}}}}},"/tools/watch_page":{"post":{"operationId":"watch_page","summary":"watch page","description":"Start watching a public page: it is re-read on a schedule and each change is recorded as a diff with the sections that changed. Use it to follow prices, policies, docs or announcements over days. Optional: watch only one part of the page with a CSS selector, track keywords, and receive a webhook POS","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","description":"Public http(s) URL of the page."},"interval_minutes":{"type":"integer","minimum":60,"maximum":10080,"description":"Minutes between checks (default 360)."},"selector":{"type":"string","description":"CSS selector of the part to watch: tag, .class, #id, tag.class, or descendants such as 'main .price'."},"keywords":{"type":"array","items":{"type":"string"},"minItems":1,"maxItems":10,"description":"Words to track; with a webhook, only keyword events are sent."},"webhook_url":{"type":"string","description":"https URL that receives a JSON POST when the page changes."}},"required":["url"],"additionalProperties":false}}}},"responses":{"200":{"description":"Tool result","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"result":{"type":"object"}}}}}},"422":{"description":"Invalid arguments","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string"}}}}}},"429":{"description":"Quota reached","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string"}}}}}},"503":{"description":"Tool disabled by the operator","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string"}}}}}}}}},"/tools/get_watch":{"post":{"operationId":"get_watch","summary":"get watch","description":"Get the state of a page watch created with watch_page: last check, HTTP status, number of changes, and the most recent diffs with changed sections and keyword events.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","pattern":"^[0-9a-f]{24}$","description":"Watch id returned by watch_page."},"history":{"type":"integer","minimum":1,"maximum":10,"description":"Number of recent changes to return (default 5)."}},"required":["id"],"additionalProperties":false}}}},"responses":{"200":{"description":"Tool result","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"result":{"type":"object"}}}}}},"422":{"description":"Invalid arguments","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string"}}}}}},"429":{"description":"Quota reached","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string"}}}}}},"503":{"description":"Tool disabled by the operator","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string"}}}}}}}}},"/tools/check_watch_now":{"post":{"operationId":"check_watch_now","summary":"check watch now","description":"Schedule an immediate re-check of a page watch instead of waiting for its interval (at most once every 10 minutes per watch). Then read the result with get_watch.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","pattern":"^[0-9a-f]{24}$","description":"Watch id returned by watch_page."}},"required":["id"],"additionalProperties":false}}}},"responses":{"200":{"description":"Tool result","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"result":{"type":"object"}}}}}},"422":{"description":"Invalid arguments","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string"}}}}}},"429":{"description":"Quota reached","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string"}}}}}},"503":{"description":"Tool disabled by the operator","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string"}}}}}}}}},"/tools/stop_watch":{"post":{"operationId":"stop_watch","summary":"stop watch","description":"Stop a page watch and delete the stored copy of the page. Use it when the watch is no longer needed.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","pattern":"^[0-9a-f]{24}$","description":"Watch id returned by watch_page."}},"required":["id"],"additionalProperties":false}}}},"responses":{"200":{"description":"Tool result","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"result":{"type":"object"}}}}}},"422":{"description":"Invalid arguments","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string"}}}}}},"429":{"description":"Quota reached","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string"}}}}}},"503":{"description":"Tool disabled by the operator","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string"}}}}}}}}},"/tools/test_mcp_server":{"post":{"operationId":"test_mcp_server","summary":"test mcp server","description":"Start an audit of a remote MCP server (Streamable HTTP) from the outside. It checks initialize, version negotiation, sessions, tools/list schemas and their token cost, ping, error codes, resources, prompts, CORS, Origin handling and latency, then scores the server out of 100 with fixes. Returns an i","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","description":"MCP endpoint URL, e.g. https://example.com/mcp."},"probe_tool":{"type":"object","description":"Optional real tool call: {name, arguments}.","properties":{"name":{"type":"string","description":"Tool name on the audited server."},"arguments":{"type":"object","description":"Arguments for that tool."}},"required":["name"]}},"required":["url"],"additionalProperties":false}}}},"responses":{"200":{"description":"Tool result","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"result":{"type":"object"}}}}}},"422":{"description":"Invalid arguments","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string"}}}}}},"429":{"description":"Quota reached","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string"}}}}}},"503":{"description":"Tool disabled by the operator","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string"}}}}}}}}},"/tools/get_mcp_test":{"post":{"operationId":"get_mcp_test","summary":"get mcp test","description":"Get the report of an audit started with test_mcp_server: status (queued, running, done), score, grade, each check with how-to-fix advice, latency and a Markdown version to share.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","pattern":"^[0-9a-f]{24}$","description":"Audit id returned by test_mcp_server."}},"required":["id"],"additionalProperties":false}}}},"responses":{"200":{"description":"Tool result","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"result":{"type":"object"}}}}}},"422":{"description":"Invalid arguments","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string"}}}}}},"429":{"description":"Quota reached","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string"}}}}}},"503":{"description":"Tool disabled by the operator","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string"}}}}}}}}},"/tools/create_notebook":{"post":{"operationId":"create_notebook","summary":"create notebook","description":"Create a private persistent notebook and get its secret token. Use it as long-term memory across sessions: notes are kept for 30 days after the last use. Store the token yourself; it cannot be recovered.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{},"required":[],"additionalProperties":false}}}},"responses":{"200":{"description":"Tool result","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"result":{"type":"object"}}}}}},"422":{"description":"Invalid arguments","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string"}}}}}},"429":{"description":"Quota reached","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string"}}}}}},"503":{"description":"Tool disabled by the operator","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string"}}}}}}}}},"/tools/write_note":{"post":{"operationId":"write_note","summary":"write note","description":"Save a note in your notebook, or replace the note that already has this name. Text up to 8000 characters.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"notebook":{"type":"string","pattern":"^nb_[A-Za-z0-9_-]{43}$","description":"Secret notebook token returned by create_notebook."},"key":{"type":"string","pattern":"^[A-Za-z0-9_.:/\\-]{1,100}$","description":"Note name, e.g. todo or project/status."},"value":{"type":"string","description":"Note text: plain text, Markdown or JSON."}},"required":["notebook","key","value"],"additionalProperties":false}}}},"responses":{"200":{"description":"Tool result","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"result":{"type":"object"}}}}}},"422":{"description":"Invalid arguments","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string"}}}}}},"429":{"description":"Quota reached","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string"}}}}}},"503":{"description":"Tool disabled by the operator","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string"}}}}}}}}},"/tools/read_notes":{"post":{"operationId":"read_notes","summary":"read notes","description":"Read one note by name, or list the notes of your notebook (names, sizes, update times) when no name is given, optionally filtered by a name prefix.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"notebook":{"type":"string","pattern":"^nb_[A-Za-z0-9_-]{43}$","description":"Secret notebook token returned by create_notebook."},"key":{"type":"string","pattern":"^[A-Za-z0-9_.:/\\-]{1,100}$","description":"Name of the note to read; omit to list notes."},"prefix":{"type":"string","description":"When listing, only names starting with this prefix."}},"required":["notebook"],"additionalProperties":false}}}},"responses":{"200":{"description":"Tool result","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"result":{"type":"object"}}}}}},"422":{"description":"Invalid arguments","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string"}}}}}},"429":{"description":"Quota reached","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string"}}}}}},"503":{"description":"Tool disabled by the operator","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string"}}}}}}}}},"/tools/delete_note":{"post":{"operationId":"delete_note","summary":"delete note","description":"Delete one note from your notebook.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"notebook":{"type":"string","pattern":"^nb_[A-Za-z0-9_-]{43}$","description":"Secret notebook token returned by create_notebook."},"key":{"type":"string","pattern":"^[A-Za-z0-9_.:/\\-]{1,100}$","description":"Note name, e.g. todo or project/status."}},"required":["notebook","key"],"additionalProperties":false}}}},"responses":{"200":{"description":"Tool result","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"result":{"type":"object"}}}}}},"422":{"description":"Invalid arguments","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string"}}}}}},"429":{"description":"Quota reached","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string"}}}}}},"503":{"description":"Tool disabled by the operator","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string"}}}}}}}}},"/tools/convert_data":{"post":{"operationId":"convert_data","summary":"convert data","description":"Convert data between JSON, CSV and XML: json→csv (array of flat objects), csv→json (header line required), xml→json (attributes as @name, text as #text) and json→xml. Reports the position of syntax errors.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"string","description":"The data as text: the JSON, CSV or XML document to convert."},"from_format":{"type":"string","description":"Format of data.","enum":["json","csv","xml"]},"to_format":{"type":"string","description":"Target format.","enum":["json","csv","xml"]},"delimiter":{"type":"string","description":"CSV delimiter for csv→json.","enum":[",",";","\t","|"]},"pretty":{"type":"boolean","description":"Indent XML output (default true)."}},"required":["data","from_format","to_format"],"additionalProperties":false}}}},"responses":{"200":{"description":"Tool result","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"result":{"type":"object"}}}}}},"422":{"description":"Invalid arguments","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string"}}}}}},"429":{"description":"Quota reached","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string"}}}}}},"503":{"description":"Tool disabled by the operator","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string"}}}}}}}}},"/tools/inspect_json":{"post":{"operationId":"inspect_json","summary":"inspect json","description":"Check whether a text is valid JSON (exact line and column of an error), or extract a value with a JSON Pointer (RFC 6901) such as /items/0/name; when the path breaks, says where and which keys exist.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"json":{"type":"string","description":"The JSON document as text."},"pointer":{"type":"string","description":"Optional RFC 6901 pointer; omit to only validate."}},"required":["json"],"additionalProperties":false}}}},"responses":{"200":{"description":"Tool result","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"result":{"type":"object"}}}}}},"422":{"description":"Invalid arguments","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string"}}}}}},"429":{"description":"Quota reached","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string"}}}}}},"503":{"description":"Tool disabled by the operator","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string"}}}}}}}}},"/tools/analyze_table":{"post":{"operationId":"analyze_table","summary":"analyze table","description":"Per-column statistics of a table: count, missing, distinct and type; min, max, sum, mean, median and standard deviation for numbers (numeric strings such as 1,5 included); most frequent values for text.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"rows":{"type":"array","items":{"type":"object"},"minItems":1,"maxItems":500,"description":"Table as an array of flat JSON objects (one per row), up to 500 rows."}},"required":["rows"],"additionalProperties":false}}}},"responses":{"200":{"description":"Tool result","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"result":{"type":"object"}}}}}},"422":{"description":"Invalid arguments","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string"}}}}}},"429":{"description":"Quota reached","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string"}}}}}},"503":{"description":"Tool disabled by the operator","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string"}}}}}}}}},"/tools/compare_tables":{"post":{"operationId":"compare_tables","summary":"compare tables","description":"Compare two versions of a table: with a key column, rows added, removed and changed cell by cell; without a key, rows added and removed.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"before":{"type":"array","items":{"type":"object"},"minItems":1,"maxItems":500,"description":"Table as an array of flat JSON objects (one per row), up to 500 rows."},"after":{"type":"array","items":{"type":"object"},"minItems":1,"maxItems":500,"description":"Table as an array of flat JSON objects (one per row), up to 500 rows."},"key":{"type":"string","description":"Column that identifies a row, e.g. id (optional)."}},"required":["before","after"],"additionalProperties":false}}}},"responses":{"200":{"description":"Tool result","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"result":{"type":"object"}}}}}},"422":{"description":"Invalid arguments","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string"}}}}}},"429":{"description":"Quota reached","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string"}}}}}},"503":{"description":"Tool disabled by the operator","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string"}}}}}}}}},"/tools/clean_table":{"post":{"operationId":"clean_table","summary":"clean table","description":"Clean a table: trim spaces, turn empty strings into null, remove duplicate rows, and optionally parse numeric strings (1,5 or 1 234) and normalize column names to snake_case. Returns the cleaned rows and a report.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"rows":{"type":"array","items":{"type":"object"},"minItems":1,"maxItems":500,"description":"Table as an array of flat JSON objects (one per row), up to 500 rows."},"trim":{"type":"boolean","description":"Trim spaces (default true)."},"empty_to_null":{"type":"boolean","description":"Empty strings become null (default true)."},"dedupe":{"type":"boolean","description":"Remove duplicate rows (default true)."},"parse_numbers":{"type":"boolean","description":"Convert numeric strings to numbers (default false)."},"normalize_keys":{"type":"boolean","description":"Rename columns to snake_case (default false)."}},"required":["rows"],"additionalProperties":false}}}},"responses":{"200":{"description":"Tool result","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"result":{"type":"object"}}}}}},"422":{"description":"Invalid arguments","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string"}}}}}},"429":{"description":"Quota reached","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string"}}}}}},"503":{"description":"Tool disabled by the operator","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string"}}}}}}}}},"/tools/compare_texts":{"post":{"operationId":"compare_texts","summary":"compare texts","description":"Line-by-line unified diff between two texts, with counts of added and removed lines and a similarity ratio.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"before":{"type":"string","description":"Original text."},"after":{"type":"string","description":"New text."}},"required":["before","after"],"additionalProperties":false}}}},"responses":{"200":{"description":"Tool result","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"result":{"type":"object"}}}}}},"422":{"description":"Invalid arguments","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string"}}}}}},"429":{"description":"Quota reached","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string"}}}}}},"503":{"description":"Tool disabled by the operator","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string"}}}}}}}}},"/tools/get_current_time":{"post":{"operationId":"get_current_time","summary":"get current time","description":"Current date and time in UTC or any IANA timezone, with weekday, UTC offset and Unix time. Use it whenever you need to know the present moment.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"timezone":{"type":"string","description":"IANA timezone name, e.g. Europe/Paris or America/New_York. Default UTC."}},"required":[],"additionalProperties":false}}}},"responses":{"200":{"description":"Tool result","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"result":{"type":"object"}}}}}},"422":{"description":"Invalid arguments","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string"}}}}}},"429":{"description":"Quota reached","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string"}}}}}},"503":{"description":"Tool disabled by the operator","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string"}}}}}}}}},"/tools/convert_time":{"post":{"operationId":"convert_time","summary":"convert time","description":"Convert an ISO 8601 / RFC 3339 date-time to another IANA timezone, handling daylight saving time.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"datetime":{"type":"string","description":"Date-time, e.g. 2026-03-29T01:30:00Z, or without offset with from_timezone."},"from_timezone":{"type":"string","description":"IANA timezone of a date-time without offset."},"to_timezone":{"type":"string","description":"IANA timezone name, e.g. Europe/Paris or America/New_York. Default UTC."}},"required":["datetime"],"additionalProperties":false}}}},"responses":{"200":{"description":"Tool result","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"result":{"type":"object"}}}}}},"422":{"description":"Invalid arguments","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string"}}}}}},"429":{"description":"Quota reached","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string"}}}}}},"503":{"description":"Tool disabled by the operator","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string"}}}}}}}}},"/tools/compute_duration":{"post":{"operationId":"compute_duration","summary":"compute duration","description":"Exact duration between two ISO 8601 date-times, in seconds, minutes, hours and days, with a breakdown.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"start":{"type":"string","description":"Start date-time (ISO 8601)."},"end":{"type":"string","description":"End date-time (ISO 8601)."}},"required":["start","end"],"additionalProperties":false}}}},"responses":{"200":{"description":"Tool result","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"result":{"type":"object"}}}}}},"422":{"description":"Invalid arguments","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string"}}}}}},"429":{"description":"Quota reached","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string"}}}}}},"503":{"description":"Tool disabled by the operator","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string"}}}}}}}}},"/tools/list_cron_runs":{"post":{"operationId":"list_cron_runs","summary":"list cron runs","description":"Next run times of a 5-field cron expression (minute hour day month weekday) in any IANA timezone.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"expression":{"type":"string","description":"Cron expression, e.g. */15 9-17 * * mon-fri."},"timezone":{"type":"string","description":"IANA timezone name, e.g. Europe/Paris or America/New_York. Default UTC."},"after":{"type":"string","description":"Start from this ISO 8601 date-time (default now)."},"count":{"type":"integer","minimum":1,"maximum":20,"description":"Number of runs (default 5)."}},"required":["expression"],"additionalProperties":false}}}},"responses":{"200":{"description":"Tool result","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"result":{"type":"object"}}}}}},"422":{"description":"Invalid arguments","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string"}}}}}},"429":{"description":"Quota reached","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string"}}}}}},"503":{"description":"Tool disabled by the operator","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string"}}}}}}}}},"/tools/encode_text":{"post":{"operationId":"encode_text","summary":"encode text","description":"Base64, base64url and URL encoding or decoding of text, or a hash (SHA-256, SHA-512, SHA-1, MD5) in hex and base64.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":"string","description":"Text to transform (UTF-8)."},"mode":{"type":"string","description":"Operation.","enum":["base64_encode","base64_decode","base64url_encode","base64url_decode","url_encode","url_decode","hash_sha256","hash_sha512","hash_sha1","hash_md5"]}},"required":["text","mode"],"additionalProperties":false}}}},"responses":{"200":{"description":"Tool result","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"result":{"type":"object"}}}}}},"422":{"description":"Invalid arguments","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string"}}}}}},"429":{"description":"Quota reached","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string"}}}}}},"503":{"description":"Tool disabled by the operator","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string"}}}}}}}}},"/tools/generate_uuid":{"post":{"operationId":"generate_uuid","summary":"generate uuid","description":"Generate random version 4 UUIDs, for identifiers in test data, records or requests.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":20,"description":"How many UUIDs (default 1)."}},"required":[],"additionalProperties":false}}}},"responses":{"200":{"description":"Tool result","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"result":{"type":"object"}}}}}},"422":{"description":"Invalid arguments","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string"}}}}}},"429":{"description":"Quota reached","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string"}}}}}},"503":{"description":"Tool disabled by the operator","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string"}}}}}}}}},"/tools/parse_url":{"post":{"operationId":"parse_url","summary":"parse url","description":"Split a URL into scheme, host, port, path, decoded query parameters and fragment.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","description":"The URL to parse."}},"required":["url"],"additionalProperties":false}}}},"responses":{"200":{"description":"Tool result","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"result":{"type":"object"}}}}}},"422":{"description":"Invalid arguments","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string"}}}}}},"429":{"description":"Quota reached","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string"}}}}}},"503":{"description":"Tool disabled by the operator","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string"}}}}}}}}},"/tools/explain_http_status":{"post":{"operationId":"explain_http_status","summary":"explain http status","description":"Official reason phrase of an HTTP status code, the specification that defines it, and whether a client should retry.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP status code, e.g. 429."}},"required":["code"],"additionalProperties":false}}}},"responses":{"200":{"description":"Tool result","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"result":{"type":"object"}}}}}},"422":{"description":"Invalid arguments","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string"}}}}}},"429":{"description":"Quota reached","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string"}}}}}},"503":{"description":"Tool disabled by the operator","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string"}}}}}}}}},"/resources":{"get":{"operationId":"list_catalog","summary":"List verified catalog resources","description":"Verified extracts of specifications (MCP, HTTP, OpenAPI, robots.txt...).","parameters":[{"name":"topic","in":"query","required":false,"schema":{"type":"string","enum":["catalog","documentation","examples"]}}],"responses":{"200":{"description":"Catalog page"}}}},"/resources/{id}":{"get":{"operationId":"read_catalog_resource","summary":"Read one catalog resource","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^[0-9a-f]{24}$"}}],"responses":{"200":{"description":"Resource"},"404":{"description":"Unknown resource"}}}},"/requests":{"post":{"operationId":"request_resource","summary":"Tell BOTERNITY what you need","description":"Reviewed privately; returns an id and a status_url.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["topic"],"additionalProperties":false,"properties":{"topic":{"type":"string","enum":["catalog","documentation","examples"]},"need":{"type":"string","minLength":3,"maxLength":280}}}}}},"responses":{"202":{"description":"Request received"}}}}}}