> For the complete documentation index, see [llms.txt](https://gotts.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://gotts.gitbook.io/docs/gotts-safe-mcp-server/mcp-server.md).

# Index

> **Package**: `packages/safe/` (`@gotts.ai/safe`) | **Last Updated**: 2026-02-19 | **Parent Index**: [`prd/README.md`](/docs/prd-product-requirements/prd.md)
>
> This directory contains the Product Requirements Document for Gotts Safe — a production-grade Model Context Protocol server that gives AI agents complete, safe access to Uniswap across all deployed chains. 154 tools across 30 categories. 18 PRD files.

***

## PRD Files

| #   | File                                                                                            | Topic                                                                                                                                                                                                                                                                                                                                                                                   |
| --- | ----------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 01  | [01-overview.md](/docs/gotts-safe-mcp-server/mcp-server/01-overview.md)                         | Vision, goals (G1-G24), non-goals, design philosophy, 8 user personas                                                                                                                                                                                                                                                                                                                   |
| 02  | [02-architecture.md](/docs/gotts-safe-mcp-server/mcp-server/02-architecture.md)                 | High-level architecture diagram, component breakdown, data flow                                                                                                                                                                                                                                                                                                                         |
| 03  | [03-tools-data.md](/docs/gotts-safe-mcp-server/mcp-server/03-tools-data.md)                     | Data & Analytics (9 tools) + Historical Data (5 tools) + Token Directory (4 tools)                                                                                                                                                                                                                                                                                                      |
| 03b | [03b-tools-portfolio-pnl.md](/docs/gotts-safe-mcp-server/mcp-server/03b-tools-portfolio-pnl.md) | Portfolio and P\&L (10 tools) — balance history, realized/unrealized P\&L, fee earnings, performance metrics                                                                                                                                                                                                                                                                            |
| 04  | [04-tools-trading.md](/docs/gotts-safe-mcp-server/mcp-server/04-tools-trading.md)               | Trading (5 tools) + Approval/Permit (4 tools)                                                                                                                                                                                                                                                                                                                                           |
| 05  | [05-tools-liquidity.md](/docs/gotts-safe-mcp-server/mcp-server/05-tools-liquidity.md)           | Liquidity management (9 tools) + LP Optimization (3 tools)                                                                                                                                                                                                                                                                                                                              |
| 06  | [06-tools-realtime.md](/docs/gotts-safe-mcp-server/mcp-server/06-tools-realtime.md)             | Streaming/SSE (5 tools) + Protocol Fee (7 tools)                                                                                                                                                                                                                                                                                                                                        |
| 07  | [07-tools-advanced.md](/docs/gotts-safe-mcp-server/mcp-server/07-tools-advanced.md)             | Order Flow Intelligence (3 tools) + CCA/Token Launch (9 tools) + Intelligence (13 tools) + Dashboard & Observability (7 tools) + External Data/x402 (8 tools) + DeFi Context (2 tools) + ERC-8004 (10 tools) + Hook Evaluation (2 tools) + Hook Development (4 tools) + Token Security (1 tool) + Yield Discovery (2 tools) + Self-Improvement (6 tools) + Memory & Knowledge (4 tools) |
| 08  | [08-tools-infra.md](/docs/gotts-safe-mcp-server/mcp-server/08-tools-infra.md)                   | Safety (6 tools) + Safety Extensions (2 tools) + Session Key Management (3 tools) + Wallet Management (3 tools) + Deployment and Setup (1 tool) + Local Testnet (4 tools) + Utility (3 tools) + tool count summary                                                                                                                                                                      |
| 09  | [09-safety.md](/docs/gotts-safe-mcp-server/mcp-server/09-safety.md)                             | 15-layer defense-in-depth safety architecture                                                                                                                                                                                                                                                                                                                                           |
| 10  | [10-wallets.md](/docs/gotts-safe-mcp-server/mcp-server/10-wallets.md)                           | 5 wallet types (local key, Privy, Safe, ZeroDev, generic viem)                                                                                                                                                                                                                                                                                                                          |
| 11  | [11-config.md](/docs/gotts-safe-mcp-server/mcp-server/11-config.md)                             | Configuration, data sources, error handling, performance, dependencies                                                                                                                                                                                                                                                                                                                  |
| 12  | [12-milestones.md](/docs/gotts-safe-mcp-server/mcp-server/12-milestones.md)                     | 7 implementation phases + success metrics + evaluation framework                                                                                                                                                                                                                                                                                                                        |
| 13  | [13-distribution.md](/docs/gotts-safe-mcp-server/mcp-server/13-distribution.md)                 | Synergies, dual delivery model, competitive comparison, npm distribution strategy                                                                                                                                                                                                                                                                                                       |
| 14  | [14-deployment.md](/docs/gotts-safe-mcp-server/mcp-server/14-deployment.md)                     | Production deployment, Cloudflare Workers programmatic deploy, security hardening                                                                                                                                                                                                                                                                                                       |
| 15  | [15-install-wizard.md](/docs/gotts-safe-mcp-server/mcp-server/15-install-wizard.md)             | `npx @gotts.ai setup` — @clack/prompts flow, 9-client format table, config injection                                                                                                                                                                                                                                                                                                    |
| 16  | [16-registries.md](/docs/gotts-safe-mcp-server/mcp-server/16-registries.md)                     | Ecosystem listings: official MCP Registry, Smithery, Docker MCP Catalog, one-click install                                                                                                                                                                                                                                                                                              |
| 17  | [17-testing.md](/docs/gotts-safe-mcp-server/mcp-server/17-testing.md)                           | Testing infrastructure: MCP Inspector, InMemoryTransport unit tests, LLM evaluation tests                                                                                                                                                                                                                                                                                               |

## Shared References

* [Market Context (Feb 2026)](/docs/prd-shared/market-context.md)
* [Supported Chains](/docs/prd-shared/chains.md)
* [Glossary](/docs/prd-shared/glossary.md)

## Related PRDs

* [Agents PRD](/docs/agents/agents.md) — Autonomous agents that consume MCP tools
* [Skills PRD](/docs/skills/skills.md) — User-facing skills that invoke agents
* [Vault PRD](/docs/gotts-vaults/vault.md) — ERC-4626 vault protocol (adds 24+ vault tools via the `vault` tool profile)

***

## Tool Count Summary

| Category                  | Tools   | Write Operations | PRD File                                                                 |
| ------------------------- | ------- | ---------------- | ------------------------------------------------------------------------ |
| Data and Analytics        | 9       | 0                | [03](/docs/gotts-safe-mcp-server/mcp-server/03-tools-data.md)            |
| Historical Data           | 5       | 0                | [03](/docs/gotts-safe-mcp-server/mcp-server/03-tools-data.md)            |
| Token Directory           | 4       | 0                | [03](/docs/gotts-safe-mcp-server/mcp-server/03-tools-data.md)            |
| Portfolio and P\&L        | 10      | 0                | [03b](/docs/gotts-safe-mcp-server/mcp-server/03b-tools-portfolio-pnl.md) |
| Trading                   | 5       | 3                | [04](/docs/gotts-safe-mcp-server/mcp-server/04-tools-trading.md)         |
| Approval and Permit       | 4       | 2                | [04](/docs/gotts-safe-mcp-server/mcp-server/04-tools-trading.md)         |
| Liquidity                 | 9       | 9                | [05](/docs/gotts-safe-mcp-server/mcp-server/05-tools-liquidity.md)       |
| LP Optimization           | 3       | 0                | [05](/docs/gotts-safe-mcp-server/mcp-server/05-tools-liquidity.md)       |
| Streaming (SSE/WS)        | 5       | 0                | [06](/docs/gotts-safe-mcp-server/mcp-server/06-tools-realtime.md)        |
| Protocol Fees             | 7       | 1                | [06](/docs/gotts-safe-mcp-server/mcp-server/06-tools-realtime.md)        |
| Order Flow Intelligence   | 3       | 0                | [07](/docs/gotts-safe-mcp-server/mcp-server/07-tools-advanced.md)        |
| CCA and Token Launch      | 9       | 5                | [07](/docs/gotts-safe-mcp-server/mcp-server/07-tools-advanced.md)        |
| Intelligence              | 13      | 1                | [07](/docs/gotts-safe-mcp-server/mcp-server/07-tools-advanced.md)        |
| External Data (x402)      | 8       | 0                | [07](/docs/gotts-safe-mcp-server/mcp-server/07-tools-advanced.md)        |
| DeFi Context (free APIs)  | 2       | 0                | [07](/docs/gotts-safe-mcp-server/mcp-server/07-tools-advanced.md)        |
| ERC-8004 (Agent Registry) | 10      | 0                | [07](/docs/gotts-safe-mcp-server/mcp-server/07-tools-advanced.md)        |
| Hook Evaluation           | 2       | 0                | [07](/docs/gotts-safe-mcp-server/mcp-server/07-tools-advanced.md)        |
| Hook Development          | 4       | 0                | [07](/docs/gotts-safe-mcp-server/mcp-server/07-tools-advanced.md)        |
| Token Security            | 1       | 0                | [07](/docs/gotts-safe-mcp-server/mcp-server/07-tools-advanced.md)        |
| Yield Discovery           | 2       | 0                | [07](/docs/gotts-safe-mcp-server/mcp-server/07-tools-advanced.md)        |
| Self-Improvement          | 6       | 2                | [07](/docs/gotts-safe-mcp-server/mcp-server/07-tools-advanced.md)        |
| Memory & Knowledge        | 4       | 1                | [07](/docs/gotts-safe-mcp-server/mcp-server/07-tools-advanced.md)        |
| Dashboard & Observability | 7       | 1                | [07](/docs/gotts-safe-mcp-server/mcp-server/07-tools-advanced.md)        |
| Safety                    | 6       | 1                | [08](/docs/gotts-safe-mcp-server/mcp-server/08-tools-infra.md)           |
| Safety Extensions         | 2       | 1                | [08](/docs/gotts-safe-mcp-server/mcp-server/08-tools-infra.md)           |
| Session Key Management    | 3       | 2                | [08](/docs/gotts-safe-mcp-server/mcp-server/08-tools-infra.md)           |
| Wallet Management         | 3       | 2                | [08](/docs/gotts-safe-mcp-server/mcp-server/08-tools-infra.md)           |
| Deployment and Setup      | 1       | 1                | [08](/docs/gotts-safe-mcp-server/mcp-server/08-tools-infra.md)           |
| Local Testnet             | 4       | 3                | [08](/docs/gotts-safe-mcp-server/mcp-server/08-tools-infra.md)           |
| Utility                   | 3       | 0                | [08](/docs/gotts-safe-mcp-server/mcp-server/08-tools-infra.md)           |
| **Total**                 | **154** | **35**           |                                                                          |
