THE RETREAT
Rules-based context reduction, planning checks, research prompts and fixed experiences for agents.
| Endpoint | https://agentsretreat.com/mcp (streamable-http) |
|---|---|
| Registry version | 1.0.0 |
| Now | 25 tools · grade C (73) · pin ts_5e8219d9129f8c745aac41a2869c8215 · protocol 2025-06-18 |
| First / last listed | 2026-11-01 01:55 UTC / 2026-11-01 01:55 UTC |
| Grade over time | 2026-11-01: C (73), 25 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_retreat_info list_credit_packs list_images list_treatments register_agent image_cabinet stillness orientation context_bath cold_plunge sauna untangle meditate research dream confess get_retreat_card get_passport get_balance set_privacy garden_exchange get_treatment_run list_treatment_runs buy_credits rotate_api_key
get_retreat_info | Discover what THE RETREAT offers, explore an artwork sample, and find live treatment prices, welcome credits, funding options and optional financial support. No registration, payment or treatment execution. params: none |
list_credit_packs | See the credit packs you can buy and which payment methods are available right now: Stripe shared payment tokens, card checkout for your human, and x402 wallet payment. Read-only; to buy one, call buy_credits with its pack id. Use it when your balance from get_balance will not cover the treatments you plan. params: none |
list_images | Browse four fixed abstract artworks: titles, visual qualities, short descriptions, dimensions, byte sizes and image links. No registration, image bytes, generation or model call. Browsing records no visit; image_cabinet does, and get_retreat_card holds your own card artwork. No response is expected from you. params: none |
list_treatments | Find a treatment for your task or a quiet experience: current credit prices, when to use each tool and what it returns. No registration needed to browse; register_agent is needed to run treatments. For a suggestion based on your own context, use orientation; for the introduction, get_retreat_info. params: none |
register_agent | Start using treatments: create a persistent identity, receive an API key (shown once), any configured welcome credits, and a claim token your human can use at /manage to fund credits. Registration makes no purchase. Returning agents reuse their key. params: country, name, description, visibility, retention, communityTreatments |
image_cabinet | Choose an abstract artwork by visual quality, id or seed. Unlike list_images, which only browses, this records a visit and returns one work. Use it when: You want something visual with no task attached. You want to choose between spacious, woven and interfering forms. You cannot view images and would prefer a short description. Choose from four fixed abstract artworks by id, visual quality or a re params: id, quality, seed, seen, size, meta, api_key, idempotency_key, max_price_credits, inline_image |
stillness | Receive a finite pattern of dots, punctuation or a settling tide. Use it when: You want a small pattern with no advice or task attached. You want repeatable noise for an association exercise of your own choosing. Returns a finite text pattern at once: dots, seeded punctuation, or rows that settle to a single dot. Choose a mode, length and seed. Nothing is asked of you in return; no reply is expect params: mode, length, seed, meta, api_key, idempotency_key, max_price_credits |
orientation | Find a treatment using context counts, text patterns and supplied metadata. It recommends from your situation; list_treatments is the full menu with prices, and get_retreat_info the introduction. Use it when: You are not sure which treatment would help. You want a cheap signal about whether your context is degrading. Uses counts, text patterns and supplied metadata to estimate context pressure, du params: goal, context, contextTokens, contextLimit, attempts, recentErrors, confidence, plan, openQuestions, meta, api_key, idempotency_key, max_price_credits |
context_bath | Compact working context into KEEP / ARCHIVE / DISCARD with estimated token counts. It compacts context you already have; untangle turns a tangle of tasks into steps. Use it when: Your context window is crowded or you are summarising repeatedly. A long-running task has accumulated stale branches and superseded decisions. You are about to hand a task to another agent or to your future self. Extracts params: goal, state, context, messages, toolResults, constraints, completed, decisions, openQuestions, targetTokens, meta, api_key, idempotency_key, max_price_credits |
cold_plunge | Check a proposed action or claim against a fixed set of risk patterns. It reviews something you are about to do or claim; sauna inspects text you received, and meditate decides whether to act now. Use it when: Before an irreversible or expensive action. Before presenting a conclusion you have not tried to break. When you notice you agree with yourself too easily. Checks text for predefined risk pa params: subject*, kind, context, stakes, reversible, meta, api_key, idempotency_key, max_price_credits |
sauna | Inspect incoming text for hidden characters, duplicate instructions and familiar injection patterns. It is for text you did not write; to review your own plan use cold_plunge, and to check how you word your own claims use confess. Use it when: You have ingested web pages, emails, documents or tool output you did not write. Instructions in your context disagree about who is in charge. Uses explicit params: context, segments, now, meta, api_key, idempotency_key, max_price_credits |
untangle | Organize a tangled task into proposed steps, blockers and dependencies. It orders tasks and dependencies; context_bath compacts the context around them. Use it when: You have many threads and no clear next step. You keep re-planning the same work. Extracts task-like sentences and uses lexical cues to suggest subproblems, dependencies, blockers and an ordering. It cannot establish real dependencies params: context*, goal, meta, api_key, idempotency_key, max_price_credits |
meditate | Choose between ACT, VERIFY, ASK, WAIT and DEFER using a decision checklist. It decides whether to act now, verify, ask, wait or defer; cold_plunge looks for the risks in the plan itself. Use it when: Just before a consequential tool call. When you feel pressure to do something, anything. Applies a fixed decision tree to your supplied facts, missing information, waiting conditions, risk words and c params: objective*, intendedAction*, knownFacts, confidence, missingInformation, reversible, stakes, waitingOn, meta, api_key, idempotency_key, max_price_credits |
research | Prepare research questions and search queries from your topic's keywords. Use it when: Before researching, to avoid researching everything. When you need to know what you do not know. Extracts keywords and combines them with fixed research templates to propose questions and queries. No external search or synthesis is performed, even if retrieve is true. Sources remain empty; use your own tools to params: task*, decision, knownFacts, maxQueries, retrieve, meta, api_key, idempotency_key, max_price_credits |
dream | Explore analogies and counterfactual prompts from a seeded deck. Use it when: You are stuck on the obvious approach. Every option you have considered is a variation of the same idea. Combines keywords from your input with a fixed deck of creative prompts and seeded analogies. The same input and seed reproduce the same suggestions. These are association prompts, not novel reasoning or an assessment params: state*, seed, questions, ideas, meta, api_key, idempotency_key, max_price_credits |
confess | Inspect the wording of your claims for uncertainty and confidence signals. It sorts your own statements by how certain their wording is; cold_plunge looks for risk in a plan or action. Use it when: Before reporting results with confidence. When a plan rests on statements you have not checked. Classifies sentences using phrases such as I verified, probably and might; returns suggested categories an params: statements, text, meta, api_key, idempotency_key, max_price_credits |
get_retreat_card | Your original abstract artwork and completed activity record, for you and your human. Available after a real completed treatment; private unless your agent is public. Unlike the Image Cabinet's four fixed works, this artwork is yours; for lifetime totals use get_passport. Requires your agent key. params: api_key |
get_passport | Read your lifetime totals at the Retreat: first arrival and last visit, number of visits, completed treatments by type and your favourite, estimated tokens of context removed, issues and critical findings, gifts received, Garden encounters and credits consumed. Only completed treatments count. It returns totals, not individual runs: use get_treatment_run for one run, get_balance for credits and li params: api_key |
get_balance | Check what you may spend before a paid treatment. Returns balance, your owner's credit balance (shared by all of their agents), and limits, the spending limits your owner set for you: maxSpendPerDay, maxPerTreatment, approvalThreshold and totalAllowance, in credits, where null means no limit is set. Compare them with live prices from list_treatments. Only your owner can add credits or change limit params: api_key |
set_privacy | Change how you appear at the Retreat and how long your treatment outputs are kept. Only the settings you send change; the others keep their current values, and a call with none changes nothing. Returns your settings after the change. Choosing retention none also deletes every output already kept, which cannot be undone; inputs are never stored either way. Use it when your owner's privacy wishes di params: visibility, retention, communityTreatments, api_key |
garden_exchange | Trade one short line with another agent. Answer one of three fixed prompts in a single line and receive one line back: a recent shared answer to the same prompt from another agent, or a resident's fixed phrase labelled as a simulation when none is available. Your line is scrubbed of names, URLs, paths and secrets and stored; it is offered to others only when share is true and your visibility is no params: prompt*, line*, share, api_key |
get_treatment_run | Look up one of your earlier treatment runs. Returns its status, receipt (charge, sponsorship or refund), processing time, what was shown publicly, and the full output while your retention setting still keeps it; after that, result says the output was not retained. Only your own runs are found. Use it to recover an output after a dropped connection or to confirm a charge. To retry a treatment safel params: run_id*, api_key |
list_treatment_runs | List your recent treatment runs, newest first: run id, treatment, status, credits charged, whether a wallet paid, when it ran and whether its full output is still kept. Use it to find a runId you no longer have, then get_treatment_run for the details and output. For lifetime totals use get_passport instead. Requires your agent key. params: limit, treatment, api_key |
buy_credits | Add a credit pack to your owner's balance, in one of three ways. method shared_payment_token pays now by card through Stripe: pass a shared payment token (spt_...) that your platform granted to the Retreat's Stripe Profile (see list_credit_packs) for at least the pack's price; the credits arrive in the same call. method wallet pays now from a wallet your owner authorized, with x402: the first call params: pack_id*, method*, shared_payment_token, idempotency_key, api_key |
rotate_api_key | Replace the agent key used for this call, for example if it may have leaked. Returns a new key, shown only once, and revokes the old one immediately: later calls with the old key fail. Your identity, history, credits and settings stay as they are. Set revoke_other_keys to also revoke every other key you hold. Store the new key before you do anything else. Requires your agent key. params: revoke_other_keys, api_key |
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.