Skip to content

Commit 8d0cc78

Browse files
EricWittmannclaude
andcommitted
Update tools documentation and clean up README
Remove docs/ProposedTools.md since all proposed tools have been implemented. Add an index to docs/Tools.md and replace inline tool tables in README.md with a link to the full tools reference. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
1 parent 471eb61 commit 8d0cc78

3 files changed

Lines changed: 117 additions & 989 deletions

File tree

README.md

Lines changed: 5 additions & 42 deletions
Original file line numberDiff line numberDiff line change
@@ -33,48 +33,11 @@ Add to your MCP settings (`~/.claude/settings.json` or project `.claude/settings
3333

3434
## Tool Catalog
3535

36-
### Session Management (5 tools)
37-
38-
| Tool | Description |
39-
|------|-------------|
40-
| `document_load` | Load an OpenAPI/AsyncAPI file into a named session |
41-
| `document_create` | Create a new empty document in a named session |
42-
| `document_save` | Save a session's document to a file (JSON or YAML) |
43-
| `document_close` | Close a named session and release memory |
44-
| `document_list_sessions` | List all active sessions |
45-
46-
### Query (5 tools)
47-
48-
| Tool | Description |
49-
|------|-------------|
50-
| `document_get_info` | Get document overview (type, title, version, path/schema counts) |
51-
| `document_list_paths` | List all paths or channels with their operations |
52-
| `document_get_operation` | Get full details of a specific operation |
53-
| `document_list_schemas` | List all schema/component definitions |
54-
| `document_get_node` | Get any node by its node path |
55-
56-
### Validation (1 tool)
57-
58-
| Tool | Description |
59-
|------|-------------|
60-
| `document_validate` | Validate the document and return structured problems |
61-
62-
### Editing (5 tools)
63-
64-
| Tool | Description |
65-
|------|-------------|
66-
| `document_set_info` | Set document title, description, and/or version |
67-
| `document_add_path` | Add a new path item to an OpenAPI document |
68-
| `document_add_schema` | Add a schema definition |
69-
| `document_set_node` | Set/replace any node at a given node path |
70-
| `document_remove_node` | Remove any node by its node path |
71-
72-
### Transformation (2 tools)
73-
74-
| Tool | Description |
75-
|------|-------------|
76-
| `document_transform` | Convert between spec versions (OpenAPI 2.0 -> 3.0) |
77-
| `document_dereference` | Resolve all `$ref` references inline |
36+
The server provides **102 tools** across 5 categories: session management (7), document
37+
querying (16), document editing (76), validation (1), and transformation (2).
38+
39+
See the [full tools reference](docs/Tools.md) for detailed documentation on every tool and
40+
its parameters.
7841

7942
## MCP Resources
8043

0 commit comments

Comments
 (0)