🚀 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.mdxindex 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.cssindex 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.cssindex 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.jsonindex 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.mdxindex 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 `fastFastMCP 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 versionfastmcp>=4.0.0 # Bad - may install breaking changes```diff --git a/docs/getting-started/welcome.mdx b/docs/getting-started/welcome.mdxindex 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"autoPlaymutedloop@@ -15,6 +16,7 @@ mode: centersrc="/assets/brand/f-watercolor-waves-4-animated.mp4"></video><video+ aria-hidden="true"autoPlaymutedloopdiff --git a/docs/servers/auth/oauth-proxy.mdx b/docs/servers/auth/oauth-proxy.mdxindex 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.-+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.mdxindex 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.+```mermaidsequenceDiagramparticipant Client as Your Clientdiff --git a/docs/servers/transforms/namespacing.mdx b/docs/servers/transforms/namespacing.mdxdeleted file mode 100644index 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.mdxindex 6942f20e5..935f71c4d 100644--- a/docs/tutorials/rest-api.mdx+++ b/docs/tutorials/rest-api.mdx@@ -132,7 +132,7 @@ python api_client.pyYou 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.-+## Step 4: Customizing Route Maps