---
title: "MCP Tool Catalog"
description: "Every tool on the Tanda MCP server, and whether it reads or changes data"
---

> Documentation Index
> Fetch the complete documentation index at: https://docs.testandaccept.com/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP Tool Catalog

The Tanda MCP server is at `https://agents.testandaccept.com/mcp`. [Set it up in your client](/integrations/mcp-setup/) first.

Read tools need the `tanda:read` scope. Write tools need `tanda:write`, and usually editor access to the record too. You normally don't call these yourself: ask your assistant, and it picks the tool.

## Organizations

| Tool | Changes data | What it does |
| --- | --- | --- |
| `list_organizations` | No | Lists your organizations and which one this connection defaults to |
| `set_default_organization` | Connection only | Chooses the organization for this connection |

## Clients and projects

| Tool | Changes data | What it does |
| --- | --- | --- |
| `list_clients` | No | Lists an organization's clients |
| `create_client` | Yes | Creates a client |
| `list_projects` | No | Lists the projects you can access in an organization |
| `get_project` | No | Gets a project and how many SOWs it has |
| `create_project` | Yes | Creates a project, optionally for a client. You become its owner |
| `invite_project_member` | Yes | Creates an invitation and returns a link for you to send. It sends no email |

## Statements of work

| Tool | Changes data | What it does |
| --- | --- | --- |
| `list_sows` | No | Lists SOWs in a project or organization |
| `get_sow` | No | Gets a SOW, optionally with its items, criteria and tests |
| `list_sow_versions` | No | Lists a SOW's versions, newest first |
| `create_sow` | Yes | Creates an empty draft SOW |
| `update_sow` | Yes | Updates a SOW's details |
| `draft_sow_from_description` | No | Gathers context so the assistant can draft a SOW |
| `start_sow_generation` | Yes | Starts drafting a SOW from a description, and waits for your approval |
| `resume_sow_generation` | Yes | Approves or rejects a draft. Approving saves the SOW |
| `get_acceptance_test_plan` | No | Produces the ATP as Markdown, and lists criteria with no test |

## Task items and criteria

| Tool | Changes data | What it does |
| --- | --- | --- |
| `list_task_items` | No | Lists a SOW's task items |
| `get_task_item` | No | Gets a task item |
| `create_task_item` | Yes | Adds a task item |
| `update_task_item` | Yes | Updates a task item |
| `list_acceptance_criteria` | No | Lists a task item's criteria |
| `create_acceptance_criterion` | Yes | Adds one criterion |
| `update_acceptance_criterion` | Yes | Updates a criterion |
| `delete_acceptance_criterion` | Yes | Deletes a criterion |

## Tests and coverage

| Tool | Changes data | What it does |
| --- | --- | --- |
| `list_tests` | No | Lists a criterion's tests |
| `create_test` | Yes | Adds a test. Pass `procedure` to save its detailed steps |
| `update_test` | Yes | Updates a test |
| `delete_test` | Yes | Deletes a test |
| `propose_tests_from_criteria` | No | Gathers context so the assistant can propose tests |
| `analyze_coverage` | No | Reports which criteria have tests |
| `analyze_coverage_gaps` | No | Finds gaps in a SOW's coverage |
| `analyze_requirements_completeness` | No | Checks a SOW's requirements for gaps |
| `get_execution_settings` | No | Reads a project's settings for running code tests |
| `save_execution_settings` | Yes | Saves those settings |
| `get_code_test_runs` | No | Reads code test runs |
| `manage_code_test_run` | Yes | Configures bindings, starts runs and cancels result collection |

## Change control

| Tool | Changes data | What it does |
| --- | --- | --- |
| `list_rfcs` | No | Lists a project's RFCs |
| `get_rfc` | No | Gets an RFC |
| `create_rfc` | Yes | Creates an RFC |
| `update_rfc` | Yes | Updates an RFC |
| `link_rfc_to_sow_version` | Yes | Links an RFC to a SOW version |
| `list_root_cause_analyses` | No | Lists a project's root cause analyses |
| `get_root_cause_analysis` | No | Gets a root cause analysis |
| `create_root_cause_analysis` | Yes | Creates a root cause analysis |
| `update_root_cause_analysis` | Yes | Updates a root cause analysis |
| `link_rca_to_sow_version` | Yes | Links a root cause analysis to a SOW version |

## References and metadata

| Tool | Changes data | What it does |
| --- | --- | --- |
| `find_records_by_reference` | No | Finds Tanda records that point to an external reference |
| `get_record_annotations` | No | Reads a record's references and metadata |
| `get_record_annotation_history` | No | Reads how those changed |
| `attach_record_references` | Yes | Attaches external references to a record |
| `remove_record_reference` | Yes | Removes a reference |
| `set_record_metadata` | Yes | Sets metadata on a record |
| `remove_record_metadata` | Yes | Removes metadata |

## Assistant

| Tool | Changes data | What it does |
| --- | --- | --- |
| `ask_tanda` | Depends on your scopes | Hands a question to the Tanda assistant, which keeps history for each thread |

Source: https://docs.testandaccept.com/agents/mcp-tools/index.mdx