Skip to content

🚀 The fast, Pythonic way to build MCP servers and clients.

docs: accessibility sweep (#5174)

nate nowacka0d5779d439e
diff --git a/docs/apps/examples.mdx b/docs/apps/examples.mdx
index 5078120e7..4cd8fd19f 100644
--- a/docs/apps/examples.mdx
+++ b/docs/apps/examples.mdx
@@ -14,32 +14,32 @@ Each tile below is a working FastMCP server you can run with `fastmcp dev apps`
<Columns cols={2}>
<Tile href="#sales-dashboard" title="Sales Dashboard" description="Metrics, charts, and deal pipeline">
<div style={{overflow: "hidden", width: "100%"}}>
- <img src="/apps/images/app-example-sales-dashboard.png" />
+ <img src="/apps/images/app-example-sales-dashboard.png" alt="" />
</div>
</Tile>
<Tile href="#system-monitor" title="System Monitor" description="Live CPU, memory, disk with auto-refresh">
- <img src="/apps/images/app-example-system-dashboard.png" />
+ <img src="/apps/images/app-example-system-dashboard.png" alt="" />
</Tile>
<Tile href="#quiz" title="Quiz" description="LLM-generated trivia with scoring">
- <img src="/apps/images/app-example-quiz.png" />
+ <img src="/apps/images/app-example-quiz.png" alt="" />
</Tile>
<Tile href="#interactive-map" title="Interactive Map" description="Geocoded addresses on Leaflet">
- <img src="/apps/images/app-example-map.png" />
+ <img src="/apps/images/app-example-map.png" alt="" />
</Tile>
<Tile href="/apps/providers/file-upload" title="File Upload" description="Drag-and-drop upload provider">
- <img src="/apps/images/app-file-upload.png" />
+ <img src="/apps/images/app-file-upload.png" alt="" />
</Tile>
<Tile href="/apps/providers/approval" title="Approval" description="Human-in-the-loop confirmation">
- <img src="/apps/images/app-approval.png" />
+ <img src="/apps/images/app-approval.png" alt="" />
</Tile>
<Tile href="/apps/providers/choice" title="Choice" description="Clickable option selection">
- <img src="/apps/images/app-choice.png" />
+ <img src="/apps/images/app-choice.png" alt="" />
</Tile>
<Tile href="/apps/providers/form" title="Form Input" description="Pydantic model forms">
- <img src="/apps/images/app-form.png" />
+ <img src="/apps/images/app-form.png" alt="" />
</Tile>
<Tile href="/apps/generative" title="Generative UI" description="LLM writes the UI at runtime">
- <img src="/apps/images/app-showcase.png" />
+ <img src="/apps/images/app-showcase.png" alt="" />
</Tile>
</Columns>
diff --git a/docs/css/banner.css b/docs/css/banner.css
index 036437304..2fe858913 100644
--- a/docs/css/banner.css
+++ b/docs/css/banner.css
@@ -56,3 +56,9 @@
padding-bottom: 8px !important;
}
}
+
+@media (prefers-reduced-motion: reduce) {
+ #banner::before {
+ animation: none;
+ }
+}
diff --git a/docs/css/version-badge.css b/docs/css/version-badge.css
index 20aa16809..77e0db65a 100644
--- a/docs/css/version-badge.css
+++ b/docs/css/version-badge.css
@@ -1,8 +1,8 @@
/* Version badge -- display a badge with the current version of the documentation */
.version-badge {
- --color-text: #ff5400 !important;
+ --color-text: #c2410c !important;
--color-bg: #fef2f2 !important;
- color: #ff5400 !important;
+ color: #c2410c !important;
background: #fef2f2 !important;
border: 1px solid rgba(220, 38, 38, 0.3) !important;
transition: box-shadow 0.2s, transform 0.15s;
diff --git a/docs/docs.json b/docs/docs.json
index ceaf58941..2ca1d8a45 100644
--- a/docs/docs.json
+++ b/docs/docs.json
@@ -16,7 +16,7 @@
"dark": "#475569",
"light": "#1e3a5f"
},
- "content": "FastMCP 4 is here — built for the new MCP protocol. [See what's new](/getting-started/whats-new)."
+ "content": "FastMCP 4 is here \u2014 built for the new MCP protocol. [See what's new](/getting-started/whats-new)."
},
"colors": {
"dark": "#f72585",
@@ -24,12 +24,15 @@
"primary": "#2d00f7"
},
"contextual": {
- "options": ["copy", "view"]
+ "options": [
+ "copy",
+ "view"
+ ]
},
"description": "The fast, Pythonic way to build MCP servers and clients.",
"errors": {
"404": {
- "description": "You’ve wandered outside the context.",
+ "description": "You\u2019ve wandered outside the context.",
"redirect": false,
"title": "Don't panic."
}
@@ -308,7 +311,10 @@
"collapsed": true,
"group": "Web Frameworks",
"icon": "code",
- "pages": ["integrations/fastapi", "integrations/openapi"]
+ "pages": [
+ "integrations/fastapi",
+ "integrations/openapi"
+ ]
},
{
"collapsed": true,
@@ -383,7 +389,10 @@
"collapsed": true,
"group": "What's New",
"icon": "sparkles",
- "pages": ["updates", "changelog"]
+ "pages": [
+ "updates",
+ "changelog"
+ ]
},
"more/faq"
]
@@ -531,6 +540,10 @@
{
"destination": "/getting-started/upgrading/from-fastmcp-3",
"source": "/getting-started/upgrading/to-mcp-sdk-v2"
+ },
+ {
+ "source": "/servers/transforms/namespacing",
+ "destination": "/servers/transforms/transforms"
}
],
"search": {
diff --git a/docs/getting-started/installation.mdx b/docs/getting-started/installation.mdx
index 8e8078f65..fbc0ef0b4 100644
--- a/docs/getting-started/installation.mdx
+++ b/docs/getting-started/installation.mdx
@@ -110,8 +110,8 @@ FastMCP 3.3 moved the importable code from the `fastmcp` distribution into `fast
FastMCP follows semantic versioning with pragmatic adaptations for the rapidly evolving MCP ecosystem. Breaking changes may occur in minor versions (e.g., 2.3.x to 2.4.0) when necessary to stay current with the MCP Protocol.
For production use, always pin to exact versions:
-```
-fastmcp==4.0.0 # Good - an exact version
+```text
+fastmcp==4.0.5 # Good - an exact version
fastmcp>=4.0.0 # Bad - may install breaking changes
```
diff --git a/docs/getting-started/welcome.mdx b/docs/getting-started/welcome.mdx
index 5c13e6bdf..eec65fe0d 100644
--- a/docs/getting-started/welcome.mdx
+++ b/docs/getting-started/welcome.mdx
@@ -7,6 +7,7 @@ mode: center
---
<video
+ aria-hidden="true"
autoPlay
muted
loop
@@ -15,6 +16,7 @@ mode: center
src="/assets/brand/f-watercolor-waves-4-animated.mp4"
></video>
<video
+ aria-hidden="true"
autoPlay
muted
loop
diff --git a/docs/servers/auth/oauth-proxy.mdx b/docs/servers/auth/oauth-proxy.mdx
index 1e0f61578..33e4848eb 100644
--- a/docs/servers/auth/oauth-proxy.mdx
+++ b/docs/servers/auth/oauth-proxy.mdx
@@ -789,7 +789,7 @@ FastMCP's OAuth proxy defends against confused deputy attacks with two layers of
**Consent screen.** Before any authorization happens, you see a consent page showing the client's details, redirect URI, and requested scopes. This gives you the opportunity to review and deny suspicious requests. By default (`require_authorization_consent=True`), the page is shown on every flow, which is the strongest protection. Setting `require_authorization_consent="remember"` approves previously-approved `(client_id, redirect_uri)` pairs silently on return visits, trading some protection for UX (see below). The consent mechanism is implemented with CSRF tokens and cryptographically signed cookies to prevent tampering.
-![](/assets/images/oauth-proxy-consent-screen.png)
+![Consent page listing the client name, redirect URI, and requested scopes with approve and deny buttons](/assets/images/oauth-proxy-consent-screen.png)
The consent page automatically displays your server's name, icon, and website URL, if available. These visual identifiers help users confirm they're authorizing the correct server.
diff --git a/docs/servers/providers/proxy.mdx b/docs/servers/providers/proxy.mdx
index c961f9afa..883b5c728 100644
--- a/docs/servers/providers/proxy.mdx
+++ b/docs/servers/providers/proxy.mdx
@@ -20,6 +20,8 @@ The Proxy Provider enables:
- **Add security**: Act as a controlled gateway with authentication and authorization
- **Simplify access**: Provide a stable endpoint even if backend servers change
+The proxy sits between your client and the source server: the client sends an MCP request to the proxy, the proxy forwards it over whichever transport the backend speaks, and the response comes back the same way.
+
```mermaid
sequenceDiagram
participant Client as Your Client
diff --git a/docs/servers/transforms/namespacing.mdx b/docs/servers/transforms/namespacing.mdx
deleted file mode 100644
index 009a1ee39..000000000
--- a/docs/servers/transforms/namespacing.mdx
+++ /dev/null
@@ -1,9 +0,0 @@
----
-title: Namespacing
-sidebarTitle: Namespacing
-description: Namespace and transform components with transforms
-icon: wand-magic-sparkles
-redirect: /servers/transforms/transforms
----
-
-This page has moved to [Transforms](/servers/transforms/transforms).
diff --git a/docs/tutorials/rest-api.mdx b/docs/tutorials/rest-api.mdx
index 6942f20e5..935f71c4d 100644
--- a/docs/tutorials/rest-api.mdx
+++ b/docs/tutorials/rest-api.mdx
@@ -132,7 +132,7 @@ python api_client.py
You should see a list of generated tools (`get_users`, `get_user_by_id`) and the result of calling the `get_user_by_id` tool, which fetches data from the live JSONPlaceholder API.
-![](/assets/images/tutorial-rest-api-result.png)
+![Terminal output listing the generated get_users and get_user_by_id tools and a fetched user record](/assets/images/tutorial-rest-api-result.png)
## Step 4: Customizing Route Maps