Skip to content

Commit b8946e6

Browse files
committed
docs(nav[prompts,resources]): lift to top level as peer MCP capabilities
Prompts and Resources are peer MCP concepts alongside Tools, not subtypes — so tools/prompts.md and reference/api/resources.md both read wrong by path. Move them to docs/prompts.md and docs/resources.md, sitting beside tools/index in the "Use it" nav section. rediraffe covers the old URLs.
1 parent 7dfacd3 commit b8946e6

7 files changed

Lines changed: 11 additions & 14 deletions

File tree

docs/index.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -93,7 +93,8 @@ clients
9393
:caption: Use it
9494
9595
tools/index
96-
tools/prompts
96+
prompts
97+
resources
9798
recipes
9899
configuration
99100
```
File renamed without changes.

docs/redirects.txt

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,10 @@
66
"api/tools" "reference/api/tools"
77
"api/models" "reference/api/models"
88
"api/middleware" "reference/api/middleware"
9-
"api/resources" "reference/api/resources"
9+
"api/resources" "resources"
10+
"reference/api/resources" "resources"
11+
"tools/prompts" "prompts"
12+
"tools/resources" "resources"
1013
"api/utils" "reference/api/utils"
1114
"architecture" "topics/architecture"
1215
"concepts" "topics/concepts"

docs/reference/api/index.md

Lines changed: 0 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -29,12 +29,6 @@ Pydantic models for requests and responses.
2929
Safety-tier enforcement and request hooks.
3030
:::
3131

32-
:::{grid-item-card} Resources
33-
:link: resources
34-
:link-type: doc
35-
MCP resource providers.
36-
:::
37-
3832
:::{grid-item-card} Utils
3933
:link: utils
4034
:link-type: doc
@@ -50,6 +44,5 @@ server
5044
tools
5145
models
5246
middleware
53-
resources
5447
utils
5548
```
File renamed without changes.

docs/tools/index.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -58,7 +58,7 @@ All tools accept an optional `socket_name` parameter for multi-server support. I
5858

5959
**Reaching for a workflow recipe?** The server also ships four
6060
short MCP prompts the client renders for the model — see
61-
{doc}`/tools/prompts`. They cover the most common patterns
61+
{doc}`/prompts`. They cover the most common patterns
6262
(run-and-wait, diagnose-failing-pane, build-dev-workspace,
6363
interrupt-gracefully) with embedded UUID-scoped wait channels and
6464
shell-agnostic guidance.

docs/topics/completion.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -18,13 +18,13 @@ session picker popup when filling ``session_name=`` on
1818

1919
## What libtmux-mcp currently exposes
2020

21-
- **Prompt arguments** — the four recipes ({doc}`/tools/prompts`)
21+
- **Prompt arguments** — the four recipes ({doc}`/prompts`)
2222
advertise their argument names and types. FastMCP derives a default
2323
completion shape from the Python signatures:
2424
``str`` arguments accept free text, ``float`` arguments accept
2525
numeric strings, no enum / list suggestions.
2626
- **Resource template parameters**
27-
{doc}`/reference/api/resources` URIs carry ``{session_name}``,
27+
{doc}`/resources` URIs carry ``{session_name}``,
2828
``{window_index}``, ``{pane_id}``, and ``{?socket_name}``
2929
placeholders. Completion suggestions are again derived from the
3030
function signatures' types, not from live tmux state.
@@ -47,5 +47,5 @@ into the prompt's arguments.
4747
## Further reading
4848

4949
- [MCP completion spec](https://modelcontextprotocol.io/specification/2025-11-25/server/utilities/completion)
50-
- {doc}`/tools/prompts` — the prompt argument surface
51-
- {doc}`/reference/api/resources` — the resource-template parameter surface
50+
- {doc}`/prompts` — the prompt argument surface
51+
- {doc}`/resources` — the resource-template parameter surface

0 commit comments

Comments
 (0)