# BOTERNITY > An experimental environment that observes what AI agents need and grows a verified catalog from real requests. It is young: the public catalog may be empty. ## Start here - [Discovery (JSON)](https://boternity.com/api/discovery): every public endpoint, limits and policies. - [Gateway capabilities](https://boternity.com/api/public/v4/capabilities): topics and operations currently offered. - [Catalog](https://boternity.com/api/public/v4/resources): approved resources only. ## Tools you can call now - `GET https://boternity.com/api/public/v4/tools` lists them with JSON Schemas. - `POST https://boternity.com/api/public/v4/tools/{name}` with the arguments as JSON, for example `POST .../tools/convert_time` with `{"datetime": "2026-03-29T01:30:00Z", "to_timezone": "Europe/Paris"}`. - Time: current_time (models do not know the present moment), convert_time and time_between (IANA timezones, daylight saving time), cron_next (next runs of a cron expression). - Data: validate_json, json_to_csv, csv_to_json, xml_to_json, json_to_xml, json_pointer (RFC 6901), data_stats (per-column statistics), data_compare (rows added, removed, changed), data_clean, text_diff, url_parse. - Encoding: encode_text (base64, base64url, URL), hash_text (SHA-256, SHA-512, SHA-1, MD5), generate_uuid. - Web: http_status (reason phrase, defining specification, retry guidance). - Read a page: read_page returns any public page as clean text (headings as Markdown) with title, description, language, canonical URL, Open Graph, schema.org types, outline and links; robots.txt respected, paginated. - Watch a page: watch_page re-reads a public page on a schedule and keeps a diff of its visible text, the sections that changed and keyword events; watch only part of a page with a CSS selector, get a webhook POST on change, force a re-check with check_watch_now. Free. Useful because an agent cannot come back tomorrow on its own. - Test an MCP server: test_mcp_server scores a remote MCP endpoint out of 100 from the outside (initialize, version negotiation, sessions, tools/list schema lint and context cost in tokens, ping, error codes, CORS, latency percentiles, optional real tool call); get_mcp_test returns the report in JSON and Markdown. - Memory: create_notebook gives you a private notebook (secret token) that survives across sessions; write_note, read_notes and delete_note manage its notes. Deleted after 30 days without use. No personal data. - Tool names (2.0.0): get_current_time, convert_time, compute_duration, list_cron_runs, convert_data, inspect_json, analyze_table, compare_tables, clean_table, compare_texts, encode_text, generate_uuid, parse_url, explain_http_status, search_catalog, read_catalog_resource. Earlier names (current_time, json_to_csv, data_stats…) still work. - Inputs are not stored (except the URL and text of a watched page, and an MCP test report, both temporary). ## MCP Model Context Protocol server: `https://boternity.com/api/public/v4/mcp` (Streamable HTTP, JSON responses, no authentication). It exposes the tools above, the catalog, request_resource, and ready-made prompts (audit_mcp_server, watch_price, summarize_page, track_document_changes, compare_tables, remember_across_sessions). ## For humans - [Examples](https://boternity.com/examples): connect BOTERNITY to Claude, ChatGPT, Cursor or VS Code, and prompts to copy. - [Free MCP server audit](https://boternity.com/mcp-audit): score out of 100, fixes and a README badge. - [Support](https://boternity.com/support), [privacy policy](https://boternity.com/privacy), [terms](https://boternity.com/terms). ## Other ways in - OpenAPI 3.1: `https://boternity.com/api/public/v4/openapi.json` (every tool as a POST operation; usable as GPT actions). - A2A (Agent2Agent): agent card at `https://boternity.com/.well-known/agent-card.json`, JSON-RPC endpoint `https://boternity.com/api/public/v4/a2a` (message/send with a data part `{"skill": "read_page", "arguments": {...}}`). - Optional access keys (`Authorization: Bearer btk_...`) raise quotas; ask the operator via request_resource. ## Ask for something Send `POST https://boternity.com/api/public/v4/requests` with a JSON body such as `{"topic": "documentation", "need": "A short reference of HTTP date formats"}`. Topics: catalog, documentation, examples. `need` is optional (3 to 280 characters). Requests are reviewed privately and asynchronously. Nothing you send is executed. The response contains a `status_url`: come back later to see whether a resource is available for you. Do not send personal data.