# MCP tools overview

The tools and prompts an AI agent gets when connected to ZeroWidth, and what each one is for.

A connected AI tool gets the MCP tools below, and uses them when the person is checking before a choice, recording a choice, or looking back at results.

## Tools

| Tool | What the tool does | Changes the record |
|---|---|---|
| `recall` | Checks for earlier decisions like the one being weighed, and how they went | No |
| `context` | Gets what the team knows about a task in one call: earlier decisions and how they went, open proposals, the things involved with who owns them and what they connect to, other decisions that touched them, and open questions | No |
| `ask` | Answers a question from past decisions, citing the decisions the answer rests on | No |
| `about` | Says what the record knows about a product, system, feature, step or person | No |
| `report_decision` | Records a decision just made in the conversation | Yes |
| `propose` | Saves an idea or option that nobody has decided yet | Yes |
| `drop_proposal` | Sets an open proposal aside, with the reason | Yes |
| `recent_decisions` | Lists the newest decisions, newest first, for everyone or only the person's own | No |
| `best_and_worst` | Ranks decisions by how far their numbers moved over a period | No |
| `open_questions` | Lists the open questions put to you | No |
| `answer_question` | Answers an open question with yes, no or not sure | Yes |
| `dismiss_question` | Puts away an open question that doesn't matter | Yes |
| `wiki_get` | Reads a thing's wiki page, with past versions | No |
| `wiki_update` | Replaces a thing's wiki page | Yes |
| `add_facts` | Adds facts about how the work runs, such as who owns a step, or ends and replaces one | Yes |
| `retract_fact` | Takes back a fact, by its id | Yes |
| `merge_things` | Says two things on the map are one | Yes |
| `separate_things` | Says two things on the map are not one | Yes |
| `rename_thing` | Adds a name a thing goes by | Yes |
| `remove_thing` | Takes a name that is not a thing off the map | Yes |
| `submit_source` | Hands over a file or text to be read later; an admin starts the reading | Yes |
| `define_metric` | Defines a number the team measures, like weekly signups, and says which way is good | Yes |
| `record_readings` | Records numbers for metrics already defined | Yes |

On hosted ZeroWidth, `define_metric` and `record_readings` are offered to admins only, and `merge_things`, `separate_things`, `rename_thing` and `remove_thing` work for admins only, as does `submit_source`. A person takes back their own facts with `retract_fact`, and an admin can take back any. Self-hosted, `record_readings` is offered when ZeroWidth has a place to keep numbers.

## Prompts

ZeroWidth also offers three prompts, which many AI apps show as commands a person can pick:

- **Record a decision.** Records a choice the team just made, with why, the goal, the number that should move and when to judge the decision.
- **Check before deciding.** Looks for earlier decisions on a question before choosing.
- **My open questions.** Goes through the questions put to you, one at a time.

## First things to try

Once a tool is connected, try one of these in a chat:

> Have we decided anything about pricing before? Check ZeroWidth.

> We've decided to ship the beta to ten design partners first, so we learn before we scale. Report that to ZeroWidth.