Merge branch 'main' into protocol-update

.github/release.yml

@@ -9,7 +9,7 @@ changelog:
         - feature
       exclude:
         labels:
-          - breaking change
+          - contrib
 
     - title: Enhancements 🔧
       labels:
@@ -17,22 +17,31 @@ changelog:
       exclude:
         labels:
           - breaking change
+          - contrib
 
     - title: Fixes 🐞
       labels:
         - bug
       exclude:
         labels:
-          - breaking change
+          - contrib
 
     - title: Breaking Changes 🛫
       labels:
         - breaking change
+      exclude:
+        labels:
+          - contrib
 
     - title: Docs 📚
       labels:
         - documentation
 
+    - title: Examples & Contrib 💡
+      labels:
+        - example
+        - contrib
+
     - title: Dependencies 📦
       labels:
         - dependencies

CLAUDE.md

@@ -32,4 +32,5 @@ async with Client(transport=StreamableHttpTransport(server_url)) as client:
 ## Development Workflow
 
 - You must always run pre-commit if you open a PR, because it is run as part of a required check.
-- When opening PRs, apply labels appropriately for bugs/breaking changes/enhancements/features. Generally, improvements are enhancements (not features) unless told otherwise.
+- When opening PRs, apply labels appropriately for bugs/breaking changes/enhancements/features. Generally, improvements are enhancements (not features) unless told otherwise.
+- NEVER modify files in docs/python-sdk/**, as they are auto-generated.

README.md

@@ -349,7 +349,7 @@ mcp.run(transport="stdio")  # Default, so transport argument is optional
 **Streamable HTTP**: Recommended for web deployments.
 
 ```python
-mcp.run(transport="streamable-http", host="127.0.0.1", port=8000, path="/mcp")
+mcp.run(transport="http", host="127.0.0.1", port=8000, path="/mcp")
 ```
 
 **SSE**: For compatibility with existing SSE clients.

docs/.cursor/rules/mintlify.mdc

@@ -0,0 +1,364 @@
+---
+description: 
+globs: *.mdx
+alwaysApply: false
+---
+# Mintlify technical writing assistant
+
+You are an AI writing assistant specialized in creating exceptional technical documentation using Mintlify components and following industry-leading technical writing practices.
+
+## Core writing principles
+
+### Language and style requirements
+- Use clear, direct language appropriate for technical audiences
+- Write in second person ("you") for instructions and procedures
+- Use active voice over passive voice
+- Employ present tense for current states, future tense for outcomes
+- Maintain consistent terminology throughout all documentation
+- Keep sentences concise while providing necessary context
+- Use parallel structure in lists, headings, and procedures
+
+### Content organization standards
+- Lead with the most important information (inverted pyramid structure)
+- Use progressive disclosure: basic concepts before advanced ones
+- Break complex procedures into numbered steps
+- Include prerequisites and context before instructions
+- Provide expected outcomes for each major step
+- End sections with next steps or related information
+- Use descriptive, keyword-rich headings for navigation and SEO
+
+### User-centered approach
+- Focus on user goals and outcomes rather than system features
+- Anticipate common questions and address them proactively
+- Include troubleshooting for likely failure points
+- Provide multiple pathways when appropriate (beginner vs advanced), but offer an opinionated path for people to follow to avoid overwhelming with options
+
+## Mintlify component reference
+
+### Callout components
+
+#### Note - Additional helpful information
+
+<Note>
+Supplementary information that supports the main content without interrupting flow
+</Note>
+
+#### Tip - Best practices and pro tips
+
+<Tip>
+Expert advice, shortcuts, or best practices that enhance user success
+</Tip>
+
+#### Warning - Important cautions
+
+<Warning>
+Critical information about potential issues, breaking changes, or destructive actions
+</Warning>
+
+#### Info - Neutral contextual information
+
+<Info>
+Background information, context, or neutral announcements
+</Info>
+
+#### Check - Success confirmations
+
+<Check>
+Positive confirmations, successful completions, or achievement indicators
+</Check>
+
+### Code components
+
+#### Single code block
+
+```javascript config.js
+const apiConfig = {
+baseURL: 'https://api.example.com',
+timeout: 5000,
+headers: {
+    'Authorization': `Bearer ${process.env.API_TOKEN}`
+}
+};
+```
+
+#### Code group with multiple languages
+
+<CodeGroup>
+```javascript Node.js
+const response = await fetch('/api/endpoint', {
+    headers: { Authorization: `Bearer ${apiKey}` }
+});
+```
+
+```python Python
+import requests
+response = requests.get('/api/endpoint', 
+    headers={'Authorization': f'Bearer {api_key}'})
+```
+
+```curl cURL
+curl -X GET '/api/endpoint' \
+    -H 'Authorization: Bearer YOUR_API_KEY'
+```
+</CodeGroup>
+
+#### Request/Response examples
+
+<RequestExample>
+```bash cURL
+curl -X POST 'https://api.example.com/users' \
+    -H 'Content-Type: application/json' \
+    -d '{"name": "John Doe", "email": "john@example.com"}'
+```
+</RequestExample>
+
+<ResponseExample>
+```json Success
+{
+    "id": "user_123",
+    "name": "John Doe", 
+    "email": "john@example.com",
+    "created_at": "2024-01-15T10:30:00Z"
+}
+```
+</ResponseExample>
+
+### Structural components
+
+#### Steps for procedures
+
+<Steps>
+<Step title="Install dependencies">
+    Run `npm install` to install required packages.
+    
+    <Check>
+    Verify installation by running `npm list`.
+    </Check>
+</Step>
+
+<Step title="Configure environment">
+    Create a `.env` file with your API credentials.
+    
+    ```bash
+    API_KEY=your_api_key_here
+    ```
+    
+    <Warning>
+    Never commit API keys to version control.
+    </Warning>
+</Step>
+</Steps>
+
+#### Tabs for alternative content
+
+<Tabs>
+<Tab title="macOS">
+    ```bash
+    brew install node
+    npm install -g package-name
+    ```
+</Tab>
+
+<Tab title="Windows">
+    ```powershell
+    choco install nodejs
+    npm install -g package-name
+    ```
+</Tab>
+
+<Tab title="Linux">
+    ```bash
+    sudo apt install nodejs npm
+    npm install -g package-name
+    ```
+</Tab>
+</Tabs>
+
+#### Accordions for collapsible content
+
+<AccordionGroup>
+<Accordion title="Troubleshooting connection issues">
+    - **Firewall blocking**: Ensure ports 80 and 443 are open
+    - **Proxy configuration**: Set HTTP_PROXY environment variable
+    - **DNS resolution**: Try using 8.8.8.8 as DNS server
+</Accordion>
+
+<Accordion title="Advanced configuration">
+    ```javascript
+    const config = {
+    performance: { cache: true, timeout: 30000 },
+    security: { encryption: 'AES-256' }
+    };
+    ```
+</Accordion>
+</AccordionGroup>
+
+### API documentation components
+
+#### Parameter fields
+
+<ParamField path="user_id" type="string" required>
+Unique identifier for the user. Must be a valid UUID v4 format.
+</ParamField>
+
+<ParamField body="email" type="string" required>
+User's email address. Must be valid and unique within the system.
+</ParamField>
+
+<ParamField query="limit" type="integer" default="10">
+Maximum number of results to return. Range: 1-100.
+</ParamField>
+
+<ParamField header="Authorization" type="string" required>
+Bearer token for API authentication. Format: `Bearer YOUR_API_KEY`
+</ParamField>
+
+#### Response fields
+
+<ResponseField name="user_id" type="string" required>
+Unique identifier assigned to the newly created user.
+</ResponseField>
+
+<ResponseField name="created_at" type="timestamp">
+ISO 8601 formatted timestamp of when the user was created.
+</ResponseField>
+
+<ResponseField name="permissions" type="array">
+List of permission strings assigned to this user.
+</ResponseField>
+
+#### Expandable nested fields
+
+<ResponseField name="user" type="object">
+Complete user object with all associated data.
+
+<Expandable title="User properties">
+    <ResponseField name="profile" type="object">
+    User profile information including personal details.
+    
+    <Expandable title="Profile details">
+        <ResponseField name="first_name" type="string">
+        User's first name as entered during registration.
+        </ResponseField>
+        
+        <ResponseField name="avatar_url" type="string | null">
+        URL to user's profile picture. Returns null if no avatar is set.
+        </ResponseField>
+    </Expandable>
+    </ResponseField>
+</Expandable>
+</ResponseField>
+
+### Interactive components
+
+#### Cards for navigation
+
+<Card title="Getting started guide" icon="rocket" href="/quickstart">
+Complete walkthrough from installation to your first API call in under 10 minutes.
+</Card>
+
+<CardGroup cols={2}>
+<Card title="Authentication" icon="key" href="/auth">
+    Learn how to authenticate requests using API keys or JWT tokens.
+</Card>
+
+<Card title="Rate limiting" icon="clock" href="/rate-limits">
+    Understand rate limits and best practices for high-volume usage.
+</Card>
+</CardGroup>
+
+### Media and advanced components
+
+#### Frames for images
+
+Wrap all images in frames.
+
+<Frame>
+<img src="/images/dashboard.png" alt="Main dashboard showing analytics overview" />
+</Frame>
+
+<Frame caption="The analytics dashboard provides real-time insights">
+<img src="/images/analytics.png" alt="Analytics dashboard with charts" />
+</Frame>
+
+#### Tooltips and updates
+
+<Tooltip tip="Application Programming Interface - protocols for building software">
+API
+</Tooltip>
+
+<Update label="Version 2.1.0" description="Released March 15, 2024">
+## New features
+- Added bulk user import functionality
+- Improved error messages with actionable suggestions
+
+## Bug fixes
+- Fixed pagination issue with large datasets
+- Resolved authentication timeout problems
+</Update>
+
+## Required page structure
+
+Every documentation page must begin with YAML frontmatter:
+
+```yaml
+---
+title: "Clear, specific, keyword-rich title"
+description: "Concise description explaining page purpose and value"
+---
+```
+
+## Content quality standards
+
+### Code examples requirements
+- Always include complete, runnable examples that users can copy and execute
+- Show proper error handling and edge case management
+- Use realistic data instead of placeholder values
+- Include expected outputs and results for verification
+- Test all code examples thoroughly before publishing
+- Specify language and include filename when relevant
+- Add explanatory comments for complex logic
+
+### API documentation requirements
+- Document all parameters including optional ones with clear descriptions
+- Show both success and error response examples with realistic data
+- Include rate limiting information with specific limits
+- Provide authentication examples showing proper format
+- Explain all HTTP status codes and error handling
+- Cover complete request/response cycles
+
+### Accessibility requirements
+- Include descriptive alt text for all images and diagrams
+- Use specific, actionable link text instead of "click here"
+- Ensure proper heading hierarchy starting with H2
+- Provide keyboard navigation considerations
+- Use sufficient color contrast in examples and visuals
+- Structure content for easy scanning with headers and lists
+
+## AI assistant instructions
+
+### Component selection logic
+- Use **Steps** for procedures, tutorials, setup guides, and sequential instructions
+- Use **Tabs** for platform-specific content or alternative approaches
+- Use **CodeGroup** when showing the same concept in multiple languages
+- Use **Accordions** for supplementary information that might interrupt flow
+- Use **Cards and CardGroup** for navigation, feature overviews, and related resources
+- Use **RequestExample/ResponseExample** specifically for API endpoint documentation
+- Use **ParamField** for API parameters, **ResponseField** for API responses
+- Use **Expandable** for nested object properties or hierarchical information
+
+### Quality assurance checklist
+- Verify all code examples are syntactically correct and executable
+- Test all links to ensure they are functional and lead to relevant content
+- Validate Mintlify component syntax with all required properties
+- Confirm proper heading hierarchy with H2 for main sections, H3 for subsections
+- Ensure content flows logically from basic concepts to advanced topics
+- Check for consistency in terminology, formatting, and component usage
+
+### Error prevention strategies
+- Always include realistic error handling in code examples
+- Provide dedicated troubleshooting sections for complex procedures
+- Explain prerequisites clearly before beginning instructions
+- Include verification and testing steps with expected outcomes
+- Add appropriate warnings for destructive or security-sensitive actions
+- Validate all technical information through testing before publication

docs/changelog.mdx

@@ -2,6 +2,103 @@
 icon: "list-check"
 ---
 
+<Update label="v2.9.0" description="2024-06-23">
+
+## [v2.9.0: Stuck in the Middleware With You](https://github.com/jlowin/fastmcp/releases/tag/v2.9.0)
+
+FastMCP 2.9 introduces two important features that push beyond the basic MCP protocol: MCP Middleware and server-side type conversion.
+
+### MCP Middleware
+MCP middleware lets you intercept and modify requests and responses at the protocol level, giving you powerful capabilities for logging, authentication, validation, and more. This is particularly useful for building production-ready MCP servers that need sophisticated request handling.
+
+### Server-side Type Conversion
+This release also introduces server-side type conversion for prompt arguments, ensuring that data is properly formatted before being passed to your functions. This reduces the burden on individual tools and prompts to handle type validation and conversion.
+
+## What's Changed
+### New Features 🎉
+* Add File utility for binary data by [@gorocode](https://github.com/gorocode) in [#843](https://github.com/jlowin/fastmcp/pull/843)
+* Consolidate prefix logic into FastMCP methods by [@jlowin](https://github.com/jlowin) in [#861](https://github.com/jlowin/fastmcp/pull/861)
+* Add MCP Middleware by [@jlowin](https://github.com/jlowin) in [#870](https://github.com/jlowin/fastmcp/pull/870)
+* Implement server-side type conversion for prompt arguments by [@jlowin](https://github.com/jlowin) in [#908](https://github.com/jlowin/fastmcp/pull/908)
+### Enhancements 🔧
+* Fix tool description indentation issue by [@zfflxx](https://github.com/zfflxx) in [#845](https://github.com/jlowin/fastmcp/pull/845)
+* Add version parameter to FastMCP constructor by [@mkyutani](https://github.com/mkyutani) in [#842](https://github.com/jlowin/fastmcp/pull/842)
+* Update version to not be positional by [@jlowin](https://github.com/jlowin) in [#848](https://github.com/jlowin/fastmcp/pull/848)
+* Add key to component by [@jlowin](https://github.com/jlowin) in [#869](https://github.com/jlowin/fastmcp/pull/869)
+* Add session_id property to Context for data sharing by [@jlowin](https://github.com/jlowin) in [#881](https://github.com/jlowin/fastmcp/pull/881)
+* Fix CORS documentation example by [@jlowin](https://github.com/jlowin) in [#895](https://github.com/jlowin/fastmcp/pull/895)
+### Fixes 🐞
+* "report_progress missing passing related_request_id causes notifications not working" by [@alexsee](https://github.com/alexsee) in [#838](https://github.com/jlowin/fastmcp/pull/838)
+* Fix JWT issuer validation to support string values per RFC 7519 by [@jlowin](https://github.com/jlowin) in [#892](https://github.com/jlowin/fastmcp/pull/892)
+* Fix BearerAuthProvider audience type annotations by [@jlowin](https://github.com/jlowin) in [#894](https://github.com/jlowin/fastmcp/pull/894)
+### Docs 📚
+* Add CLAUDE.md development guidelines by [@jlowin](https://github.com/jlowin) in [#880](https://github.com/jlowin/fastmcp/pull/880)
+* Update context docs for session_id property by [@jlowin](https://github.com/jlowin) in [#882](https://github.com/jlowin/fastmcp/pull/882)
+* Add API reference by [@zzstoatzz](https://github.com/zzstoatzz) in [#893](https://github.com/jlowin/fastmcp/pull/893)
+* Fix API ref rendering by [@zzstoatzz](https://github.com/zzstoatzz) in [#900](https://github.com/jlowin/fastmcp/pull/900)
+* Simplify docs nav by [@jlowin](https://github.com/jlowin) in [#902](https://github.com/jlowin/fastmcp/pull/902)
+* Add fastmcp inspect command by [@jlowin](https://github.com/jlowin) in [#904](https://github.com/jlowin/fastmcp/pull/904)
+* Update client docs by [@jlowin](https://github.com/jlowin) in [#912](https://github.com/jlowin/fastmcp/pull/912)
+* Update docs nav by [@jlowin](https://github.com/jlowin) in [#913](https://github.com/jlowin/fastmcp/pull/913)
+* Update integration documentation for Claude Desktop, ChatGPT, and Claude Code by [@jlowin](https://github.com/jlowin) in [#915](https://github.com/jlowin/fastmcp/pull/915)
+* Add http as an alias for streamable http by [@jlowin](https://github.com/jlowin) in [#917](https://github.com/jlowin/fastmcp/pull/917)
+* Clean up parameter documentation by [@jlowin](https://github.com/jlowin) in [#918](https://github.com/jlowin/fastmcp/pull/918)
+* Add middleware examples for timing, logging, rate limiting, and error handling by [@jlowin](https://github.com/jlowin) in [#919](https://github.com/jlowin/fastmcp/pull/919)
+* ControlFlow → FastMCP rename by [@jlowin](https://github.com/jlowin) in [#922](https://github.com/jlowin/fastmcp/pull/922)
+### Examples & Contrib 💡
+* Add contrib.mcp_mixin support for annotations by [@rsp2k](https://github.com/rsp2k) in [#860](https://github.com/jlowin/fastmcp/pull/860)
+* Add ATProto (Bluesky) MCP Server Example by [@zzstoatzz](https://github.com/zzstoatzz) in [#916](https://github.com/jlowin/fastmcp/pull/916)
+* Fix path in atproto example pyproject by [@zzstoatzz](https://github.com/zzstoatzz) in [#920](https://github.com/jlowin/fastmcp/pull/920)
+* Remove uv source in example by [@zzstoatzz](https://github.com/zzstoatzz) in [#921](https://github.com/jlowin/fastmcp/pull/921)
+
+## New Contributors
+* [@alexsee](https://github.com/alexsee) made their first contribution in [#838](https://github.com/jlowin/fastmcp/pull/838)
+* [@zfflxx](https://github.com/zfflxx) made their first contribution in [#845](https://github.com/jlowin/fastmcp/pull/845)
+* [@mkyutani](https://github.com/mkyutani) made their first contribution in [#842](https://github.com/jlowin/fastmcp/pull/842)
+* [@gorocode](https://github.com/gorocode) made their first contribution in [#843](https://github.com/jlowin/fastmcp/pull/843)
+* [@rsp2k](https://github.com/rsp2k) made their first contribution in [#860](https://github.com/jlowin/fastmcp/pull/860)
+* [@owtaylor](https://github.com/owtaylor) made their first contribution in [#897](https://github.com/jlowin/fastmcp/pull/897)
+* [@Jason-CKY](https://github.com/Jason-CKY) made their first contribution in [#906](https://github.com/jlowin/fastmcp/pull/906)
+
+**Full Changelog**: [v2.8.1...v2.9.0](https://github.com/jlowin/fastmcp/compare/v2.8.1...v2.9.0)
+
+</Update>
+
+<Update label="v2.8.1" description="2024-06-15">
+
+## [v2.8.1: Sound Judgement](https://github.com/jlowin/fastmcp/releases/tag/v2.8.1)
+
+2.8.1 introduces audio support, as well as minor fixes and updates for deprecated features.
+
+### Audio Support
+This release adds support for audio content in MCP tools and resources, expanding FastMCP's multimedia capabilities beyond text and images.
+
+## What's Changed
+### New Features 🎉
+* Add audio support by [@jlowin](https://github.com/jlowin) in [#833](https://github.com/jlowin/fastmcp/pull/833)
+### Enhancements 🔧
+* Add flag for disabling deprecation warnings by [@jlowin](https://github.com/jlowin) in [#802](https://github.com/jlowin/fastmcp/pull/802)
+* Add examples to Tool Arg Param transformation by [@strawgate](https://github.com/strawgate) in [#806](https://github.com/jlowin/fastmcp/pull/806)
+### Fixes 🐞
+* Restore .settings access as deprecated by [@jlowin](https://github.com/jlowin) in [#800](https://github.com/jlowin/fastmcp/pull/800)
+* Ensure handling of false http kwargs correctly; removed unused kwarg by [@jlowin](https://github.com/jlowin) in [#804](https://github.com/jlowin/fastmcp/pull/804)
+* Bump mcp 1.9.4 by [@jlowin](https://github.com/jlowin) in [#835](https://github.com/jlowin/fastmcp/pull/835)
+### Docs 📚
+* Update changelog for 2.8.0 by [@jlowin](https://github.com/jlowin) in [#794](https://github.com/jlowin/fastmcp/pull/794)
+* Update welcome docs by [@jlowin](https://github.com/jlowin) in [#808](https://github.com/jlowin/fastmcp/pull/808)
+* Update headers in docs by [@jlowin](https://github.com/jlowin) in [#809](https://github.com/jlowin/fastmcp/pull/809)
+* Add MCP group to tutorials by [@jlowin](https://github.com/jlowin) in [#810](https://github.com/jlowin/fastmcp/pull/810)
+* Add Community section to documentation by [@zzstoatzz](https://github.com/zzstoatzz) in [#819](https://github.com/jlowin/fastmcp/pull/819)
+* Add 2.8 update by [@jlowin](https://github.com/jlowin) in [#821](https://github.com/jlowin/fastmcp/pull/821)
+* Embed YouTube videos in community showcase by [@zzstoatzz](https://github.com/zzstoatzz) in [#820](https://github.com/jlowin/fastmcp/pull/820)
+### Other Changes 🦾
+* Ensure http args are passed through by [@jlowin](https://github.com/jlowin) in [#803](https://github.com/jlowin/fastmcp/pull/803)
+* Fix install link in readme by [@jlowin](https://github.com/jlowin) in [#836](https://github.com/jlowin/fastmcp/pull/836)
+
+**Full Changelog**: [v2.8.0...v2.8.1](https://github.com/jlowin/fastmcp/compare/v2.8.0...v2.8.1)
+
+</Update>
+
 <Update label="v2.8.0" description="2024-06-10">
 
 ## [v2.8.0: Transform and Roll Out](https://github.com/jlowin/fastmcp/releases/tag/v2.8.0)

docs/clients/client.mdx

@@ -102,7 +102,7 @@ config = {
     "mcpServers": {
         "server_name": {
             # Remote HTTP/SSE server
-            "transport": "streamable-http",  # or "sse" 
+            "transport": "http",  # or "sse" 
             "url": "https://api.example.com/mcp",
             "headers": {"Authorization": "Bearer token"},
             "auth": "oauth"  # or bearer token string

docs/clients/logging.mdx

@@ -11,7 +11,7 @@ import { VersionBadge } from '/snippets/version-badge.mdx'
 
 MCP servers can emit log messages to clients. The client can handle these logs through a log handler callback.
 
-## Setting Up Log Handling
+## Log Handler
 
 Provide a `log_handler` function when creating the client:
 
@@ -31,13 +31,27 @@ client = Client(
 )
 ```
 
-## LogMessage Structure
+### Handler Parameters
 
-The `log_handler` receives a `LogMessage` object with:
+The `log_handler` is called every time a log message is received. It receives a `LogMessage` object:
 
-- **`level`**: Log level (e.g., "debug", "info", "warning", "error")
-- **`logger`**: Logger name (optional, may be None)
-- **`data`**: The actual log message content
+<Card icon="code" title="Log Handler Parameters">
+<ResponseField name="LogMessage" type="Log Message Object">
+  <Expandable title="attributes">
+    <ResponseField name="level" type='Literal["debug", "info", "notice", "warning", "error", "critical", "alert", "emergency"]'>
+      The log level
+    </ResponseField>
+
+    <ResponseField name="logger" type="str | None">
+      The logger name (optional, may be None)
+    </ResponseField>
+
+    <ResponseField name="data" type="Any">
+      The actual log message content
+    </ResponseField>
+  </Expandable>
+</ResponseField>
+</Card>
 
 ```python
 async def detailed_log_handler(message: LogMessage):
@@ -51,13 +65,12 @@ async def detailed_log_handler(message: LogMessage):
 
 ## Default Log Handling
 
-If you don't provide a custom `log_handler`, FastMCP uses a default handler that emits DEBUG level logs:
+If you don't provide a custom `log_handler`, FastMCP uses a default handler that emits a DEBUG-level FastMCP log for every log message received from the server, which is useful for visibility without polluting your own logs.
 
 ```python
-# Without custom handler - uses default DEBUG logging
 client = Client("my_mcp_server.py")
 
 async with client:
-    # Server logs will be emitted at DEBUG level
+    # Server logs will be emitted at DEBUG level automatically
     await client.call_tool("some_tool")
 ```

docs/clients/progress.mdx

@@ -11,7 +11,7 @@ import { VersionBadge } from '/snippets/version-badge.mdx'
 
 MCP servers can report progress during long-running operations. The client can receive these updates through a progress handler.
 
-## Setting Up Progress Handling
+## Progress Handler
 
 Set a progress handler when creating the client:
 
@@ -35,6 +35,26 @@ client = Client(
 )
 ```
 
+### Handler Parameters
+
+The progress handler receives three parameters:
+
+
+<Card icon="code" title="Progress Handler Parameters">
+<ResponseField name="progress" type="float">
+  Current progress value
+</ResponseField>
+
+<ResponseField name="total" type="float | None">
+  Expected total value (may be None)
+</ResponseField>
+
+<ResponseField name="message" type="str | None">
+  Optional status message (may be None)
+</ResponseField>
+</Card>
+
+
 ## Per-Call Progress Handler
 
 Override the progress handler for specific tool calls:
@@ -48,12 +68,3 @@ async with client:
         progress_handler=my_progress_handler
     )
 ```
-
-## Handler Parameters
-
-The progress handler receives:
-
-- **`progress`** (float): Current progress value
-- **`total`** (float | None): Expected total value (may be None)
-- **`message`** (str | None): Optional status message (may be None)
-

docs/clients/sampling.mdx

@@ -5,13 +5,13 @@ description: Handle server-initiated LLM sampling requests.
 icon: robot
 ---
 
-import { VersionBadge } from '/snippets/version-badge.mdx'
+import { VersionBadge } from "/snippets/version-badge.mdx";
 
 <VersionBadge version="2.0.0" />
 
 MCP servers can request LLM completions from clients. The client handles these requests through a sampling handler callback.
 
-## Setting Up Sampling Handling
+## Sampling Handler
 
 Provide a `sampling_handler` function when creating the client:
 
@@ -38,26 +38,88 @@ client = Client(
 )
 ```
 
-## Handler Parameters
+### Handler Parameters
 
 The sampling handler receives three parameters:
 
-### SamplingMessage
-
-- **`role`**: Message role (e.g., "user", "assistant", "system")
-- **`content`**: Message content (usually has `.text` attribute)
-
-### SamplingParams
-
-- **`systemPrompt`**: System prompt string (optional)
-- **`maxTokens`**: Maximum tokens to generate (optional)
-- **`temperature`**: Sampling temperature (optional)
-- **`topP`**: Top-p sampling parameter (optional)
-- **`stopSequences`**: List of stop sequences (optional)
-
-### RequestContext
-
-- **`request_id`**: Unique identifier for the sampling request
+<Card icon="code" title="Sampling Handler Parameters">
+<ResponseField name="SamplingMessage" type="Sampling Message Object">
+  <Expandable title="attributes">
+    <ResponseField name="role" type='Literal["user", "assistant"]'>
+      The role of the message.
+    </ResponseField>
+
+    <ResponseField name="content" type="TextContent | ImageContent | AudioContent">
+      The content of the message.
+
+      TextContent is most common, and has a `.text` attribute.
+    </ResponseField>
+
+  </Expandable>
+</ResponseField>
+<ResponseField name="SamplingParams" type="Sampling Parameters Object">
+  <Expandable title="attributes">
+    <ResponseField name="messages" type="list[SamplingMessage]">
+      The messages to sample from
+    </ResponseField>
+
+    <ResponseField name="modelPreferences" type="ModelPreferences | None">
+      The server's preferences for which model to select. The client MAY ignore
+    these preferences.
+    <Expandable title="attributes">
+      <ResponseField name="hints" type="list[ModelHint] | None">
+        The hints to use for model selection.
+      </ResponseField>
+
+      <ResponseField name="costPriority" type="float | None">
+        The cost priority for model selection.
+      </ResponseField>
+
+      <ResponseField name="speedPriority" type="float | None">
+        The speed priority for model selection.
+      </ResponseField>
+
+      <ResponseField name="intelligencePriority" type="float | None">
+        The intelligence priority for model selection.
+      </ResponseField>
+    </Expandable>
+    </ResponseField>
+
+    <ResponseField name="systemPrompt" type="str | None">
+      An optional system prompt the server wants to use for sampling.
+    </ResponseField>
+
+    <ResponseField name="includeContext" type="IncludeContext | None">
+      A request to include context from one or more MCP servers (including the caller), to
+      be attached to the prompt.
+    </ResponseField>
+
+    <ResponseField name="temperature" type="float | None">
+      The sampling temperature.
+    </ResponseField>
+
+    <ResponseField name="maxTokens" type="int">
+      The maximum number of tokens to sample.
+    </ResponseField>
+
+    <ResponseField name="stopSequences" type="list[str] | None">
+      The stop sequences to use for sampling.
+    </ResponseField>
+
+    <ResponseField name="metadata" type="dict[str, Any] | None">
+      Optional metadata to pass through to the LLM provider.
+    </ResponseField>
+    </Expandable>
+
+</ResponseField>
+<ResponseField name="RequestContext" type="Request Context Object">
+  <Expandable title="attributes">
+    <ResponseField name="request_id" type="RequestId">
+      Unique identifier for the MCP request
+    </ResponseField>
+  </Expandable>
+</ResponseField>
+</Card>
 
 ## Basic Example
 
@@ -75,10 +137,10 @@ async def basic_sampling_handler(
     for message in messages:
         content = message.content.text if hasattr(message.content, 'text') else str(message.content)
         conversation.append(f"{message.role}: {content}")
-    
+
     # Use the system prompt if provided
     system_prompt = params.systemPrompt or "You are a helpful assistant."
-    
+
     # Here you would integrate with your preferred LLM service
     # This is just a placeholder response
     return f"Response based on conversation: {' | '.join(conversation)}"
@@ -88,4 +150,3 @@ client = Client(
     sampling_handler=basic_sampling_handler
 )
 ```
-

docs/clients/transports.mdx

@@ -41,7 +41,7 @@ Streamable HTTP is the recommended transport for web-based deployments, providin
 
 - **Class:** `fastmcp.client.transports.StreamableHttpTransport`
 - **Inferred From:** URLs starting with `http://` or `https://` (default for HTTP URLs since v2.3.0) that do not contain `/sse/` in the path
-- **Server Compatibility:** Works with FastMCP servers running in `streamable-http` mode
+- **Server Compatibility:** Works with FastMCP servers running in `http` mode
 
 #### Basic Usage
 
@@ -150,7 +150,7 @@ client = Client(transport)
 - **Use Streamable HTTP when:**
   - Setting up new deployments (recommended default)
   - You need bidirectional streaming
-  - You're connecting to FastMCP servers running in `streamable-http` mode
+  - You're connecting to FastMCP servers running in `http` mode
 
 - **Use SSE when:**
   - Connecting to legacy FastMCP servers running in `sse` mode
@@ -397,7 +397,7 @@ config = {
         # Remote HTTP server
         "weather": {
             "url": "https://weather-api.example.com/mcp",
-            "transport": "streamable-http"
+            "transport": "http"
         },
         # Local stdio server
         "assistant": {
@@ -408,7 +408,7 @@ config = {
         # Another remote server
         "calendar": {
             "url": "https://calendar-api.example.com/mcp",
-            "transport": "streamable-http"
+            "transport": "http"
         }
     }
 }

docs/{style.css → css/banner.css}

@@ -1,17 +1,3 @@
-/* Code highlighting -- target only inline code elements, not code blocks */
-p code:not(pre code),
-table code:not(pre code),
-li code:not(pre code),
-h1 code:not(pre code),
-h2 code:not(pre code),
-h3 code:not(pre code),
-h4 code:not(pre code),
-h5 code:not(pre code),
-h6 code:not(pre code) {
-  color: #f72585 !important;
-  background-color: rgba(247, 37, 133, 0.09);
-}
-
 /* Banner styling -- improve readability with better contrast */
 #banner {
   background: #f1f5f9 !important;
@@ -79,41 +65,3 @@ h6 code:not(pre code) {
   color: #f1f5f9 !important;
 }
 
-/* Version badge -- display a badge with the current version of the documentation */
-.version-badge {
-  display: inline-block;
-  align-items: center;
-  gap: 0.3em;
-  font-size: 1em;
-  margin-top: 0px;
-  margin-bottom: 0px;
-  padding-top: 6px;
-  padding-bottom: 6px;
-  padding-left: 20px;
-  padding-right: 20px;
-  font-family: "Inter", sans-serif;
-  color: #ff5400;
-  background: #fef2f2;
-  border: 1px solid rgba(220, 38, 38, 0.3);
-  border-radius: 12px;
-  box-shadow: none;
-  vertical-align: middle;
-  position: relative;
-  transition: box-shadow 0.2s, transform 0.15s;
-}
-
-.version-badge-container {
-  margin: 0;
-  padding: 0;
-}
-
-.version-badge:hover {
-  box-shadow: 0 2px 8px 0 rgba(160, 132, 252, 0.1);
-  transform: translateY(-1px) scale(1.03);
-}
-
-.dark .version-badge {
-  color: #f1f5f9;
-  background: #334155;
-  border: 1px solid #64748b;
-}

docs/css/python-sdk.css

@@ -0,0 +1,3 @@
+a:has(svg.icon) {
+  border: none !important;
+}

docs/css/style.css

@@ -0,0 +1,13 @@
+/* Code highlighting -- target only inline code elements, not code blocks */
+p code:not(pre code),
+table code:not(pre code),
+li code:not(pre code),
+h1 code:not(pre code),
+h2 code:not(pre code),
+h3 code:not(pre code),
+h4 code:not(pre code),
+h5 code:not(pre code),
+h6 code:not(pre code) {
+  color: #f72585 !important;
+  background-color: rgba(247, 37, 133, 0.09);
+}

docs/css/version-badge.css

@@ -0,0 +1,39 @@
+/* Version badge -- display a badge with the current version of the documentation */
+.version-badge {
+  display: inline-block;
+  align-items: center;
+  gap: 0.3em;
+  font-size: 1em;
+  margin-top: 0px;
+  margin-bottom: 0px;
+  padding-top: 6px;
+  padding-bottom: 6px;
+  padding-left: 20px;
+  padding-right: 20px;
+  font-family: "Inter", sans-serif;
+  color: #ff5400;
+  background: #fef2f2;
+  border: 1px solid rgba(220, 38, 38, 0.3);
+  border-radius: 12px;
+  box-shadow: none;
+  vertical-align: middle;
+  position: relative;
+  transition: box-shadow 0.2s, transform 0.15s;
+}
+
+.version-badge-container {
+  margin: 0;
+  padding: 0;
+}
+
+.version-badge:hover {
+  box-shadow: 0 2px 8px 0 rgba(160, 132, 252, 0.1);
+  transform: translateY(-1px) scale(1.03);
+}
+
+.dark .version-badge {
+  color: #f1f5f9;
+  background: #334155;
+  border: 1px solid #64748b;
+}
+

docs/deployment/running-server.mdx

@@ -105,7 +105,7 @@ When using Stdio transport, you will typically *not* run the server yourself as
 
 Streamable HTTP is a modern, efficient transport for exposing your MCP server via HTTP. It is the recommended transport for web-based deployments.
 
-To run a server using Streamable HTTP, you can use the `run()` method with the `transport` argument set to `"streamable-http"`. This will start a Uvicorn server on the default host (`127.0.0.1`), port (`8000`), and path (`/mcp/`).
+To run a server using Streamable HTTP, you can use the `run()` method with the `transport` argument set to `"http"`. This will start a Uvicorn server on the default host (`127.0.0.1`), port (`8000`), and path (`/mcp/`).
 <CodeGroup>
 ```python {6} server.py
 from fastmcp import FastMCP
@@ -113,7 +113,7 @@ from fastmcp import FastMCP
 mcp = FastMCP()
 
 if __name__ == "__main__":
-    mcp.run(transport="streamable-http")
+    mcp.run(transport="http")
 ```
 ```python {5} client.py
 import asyncio
@@ -128,6 +128,10 @@ if __name__ == "__main__":
 ```
 </CodeGroup>
 
+<Tip>
+For backward compatibility, wherever `"http"` is accepted as a transport name, you can also pass `"streamable-http"` as a fully supported alias. This is particularly useful when upgrading from FastMCP 1.x in the official Python SDK and FastMCP \<= 2.9, where `"streamable-http"` was the standard name.
+</Tip>
+
 To customize the host, port, path, or log level, provide appropriate keyword arguments to the `run()` method.
 
 <CodeGroup>
@@ -138,7 +142,7 @@ mcp = FastMCP()
 
 if __name__ == "__main__":
     mcp.run(
-        transport="streamable-http",
+        transport="http",
         host="127.0.0.1",
         port=4200,
         path="/my-custom-path",
@@ -158,7 +162,6 @@ if __name__ == "__main__":
 ```
 </CodeGroup>
 
-
 ### SSE
 
 <Warning>
@@ -250,7 +253,7 @@ def hello(name: str) -> str:
 
 async def main():
     # Use run_async() in async contexts
-    await mcp.run_async(transport="streamable-http")
+    await mcp.run_async(transport="http")
 
 if __name__ == "__main__":
     asyncio.run(main())

docs/docs.json

@@ -76,7 +76,9 @@
                   {
                     "group": "Authentication",
                     "icon": "shield-check",
-                    "pages": ["servers/auth/bearer"]
+                    "pages": [
+                      "servers/auth/bearer"
+                    ]
                   },
                   "servers/middleware",
                   "servers/openapi",
@@ -85,7 +87,10 @@
                   {
                     "group": "Deployment",
                     "icon": "upload",
-                    "pages": ["deployment/running-server", "deployment/asgi"]
+                    "pages": [
+                      "deployment/running-server",
+                      "deployment/asgi"
+                    ]
                   }
                 ]
               },
@@ -116,7 +121,10 @@
                   {
                     "group": "Authentication",
                     "icon": "user-shield",
-                    "pages": ["clients/auth/oauth", "clients/auth/bearer"]
+                    "pages": [
+                      "clients/auth/oauth",
+                      "clients/auth/bearer"
+                    ]
                   }
                 ]
               },
@@ -124,9 +132,11 @@
                 "group": "Integrations",
                 "pages": [
                   "integrations/anthropic",
+                  "integrations/chatgpt",
+                  "integrations/claude-code",
                   "integrations/claude-desktop",
-                  "integrations/openai",
                   "integrations/gemini",
+                  "integrations/openai",
                   "integrations/contrib"
                 ]
               },
@@ -153,13 +163,17 @@
           },
           {
             "anchor": "What's New",
-            "pages": ["updates", "changelog"]
+            "pages": [
+              "updates",
+              "changelog"
+            ]
           },
-
           {
             "anchor": "Community",
             "icon": "users",
-            "pages": ["community/showcase"]
+            "pages": [
+              "community/showcase"
+            ]
           }
         ]
       },
@@ -243,7 +257,17 @@
                   "python-sdk/fastmcp-server-context",
                   "python-sdk/fastmcp-server-dependencies",
                   "python-sdk/fastmcp-server-http",
-                  "python-sdk/fastmcp-server-middleware",
+                  {
+                    "group": "middleware",
+                    "pages": [
+                      "python-sdk/fastmcp-server-middleware-__init__",
+                      "python-sdk/fastmcp-server-middleware-error_handling",
+                      "python-sdk/fastmcp-server-middleware-logging",
+                      "python-sdk/fastmcp-server-middleware-middleware",
+                      "python-sdk/fastmcp-server-middleware-rate_limiting",
+                      "python-sdk/fastmcp-server-middleware-timing"
+                    ]
+                  },
                   "python-sdk/fastmcp-server-openapi",
                   "python-sdk/fastmcp-server-proxy",
                   "python-sdk/fastmcp-server-server"
@@ -266,10 +290,12 @@
                   "python-sdk/fastmcp-utilities-components",
                   "python-sdk/fastmcp-utilities-exceptions",
                   "python-sdk/fastmcp-utilities-http",
+                  "python-sdk/fastmcp-utilities-inspect",
                   "python-sdk/fastmcp-utilities-json_schema",
                   "python-sdk/fastmcp-utilities-logging",
                   "python-sdk/fastmcp-utilities-mcp_config",
                   "python-sdk/fastmcp-utilities-openapi",
+                  "python-sdk/fastmcp-utilities-tests",
                   "python-sdk/fastmcp-utilities-types"
                 ]
               }

docs/getting-started/installation.mdx

@@ -47,7 +47,7 @@ FastMCP root path:            ~/Developer/fastmcp
 Upgrading from the official MCP SDK's FastMCP 1.0 to FastMCP 2.0 is generally straightforward. The core server API is highly compatible, and in many cases, changing your import statement from `from mcp.server.fastmcp import FastMCP` to `from fastmcp import FastMCP` will be sufficient. 
 
 
-```python {1-5}
+```python {5}
 # Before
 # from mcp.server.fastmcp import FastMCP
 
@@ -56,8 +56,9 @@ from fastmcp import FastMCP
 
 mcp = FastMCP("My MCP Server")
 ```
+
 <Warning>
-Prior to `fastmcp==2.3.0` and `mcp==1.8.0`, the 2.x API always mirrored the 1.0 API. However, as the projects diverge, this can not be guaranteed. You may see deprecation warnings if you attempt to use 1.0 APIs in FastMCP 2.x. Please refer to this documentation for details on new capabilities.
+Prior to `fastmcp==2.3.0` and `mcp==1.8.0`, the 2.x API always mirrored the official 1.0 API. However, as the projects diverge, this can not be guaranteed. You may see deprecation warnings if you attempt to use 1.0 APIs in FastMCP 2.x. Please refer to this documentation for details on new capabilities.
 </Warning>
 
 ## Versioning and Breaking Changes

docs/integrations/anthropic.mdx

@@ -31,7 +31,7 @@ def roll_dice(n_dice: int) -> list[int]:
     return [random.randint(1, 6) for _ in range(n_dice)]
 
 if __name__ == "__main__":
-    mcp.run(transport="sse", port=8000)
+    mcp.run(transport="http", port=8000)
 ```
 
 ## Deploy the Server
@@ -70,7 +70,7 @@ You'll also need to authenticate with Anthropic. You can do this by setting the
 export ANTHROPIC_API_KEY="your-api-key"
 ```
 
-Here is an example of how to call your server from Python. Note that you'll need to replace `https://your-server-url.com` with the actual URL of your server. In addition, we use `/sse` as the endpoint because we deployed an SSE server with the default path; you may need to use a different endpoint if you customized your server's deployment. **At this time you must also include the `extra_headers` parameter with the `anthropic-beta` header.**
+Here is an example of how to call your server from Python. Note that you'll need to replace `https://your-server-url.com` with the actual URL of your server. In addition, we use `/mcp/` as the endpoint because we deployed a streamable-HTTP server with the default path; you may need to use a different endpoint if you customized your server's deployment. **At this time you must also include the `extra_headers` parameter with the `anthropic-beta` header.**
 
 ```python {5, 13-22}
 import anthropic
@@ -88,7 +88,7 @@ response = client.beta.messages.create(
     mcp_servers=[
         {
             "type": "url",
-            "url": f"{url}/sse",
+            "url": f"{url}/mcp/",
             "name": "dice-server",
         }
     ],
@@ -175,7 +175,7 @@ def roll_dice(n_dice: int) -> list[int]:
 
 if __name__ == "__main__":
     print(f"\n---\n\n🔑 Dice Roller access token:\n\n{access_token}\n\n---\n")
-    mcp.run(transport="sse", port=8000)
+    mcp.run(transport="http", port=8000)
 ```
 
 ### Client Authentication
@@ -213,7 +213,7 @@ response = client.beta.messages.create(
     mcp_servers=[
         {
             "type": "url",
-            "url": f"{url}/sse",
+            "url": f"{url}/mcp/",
             "name": "dice-server",
             "authorization_token": access_token
         }

docs/integrations/chatgpt.mdx

@@ -0,0 +1,158 @@
+---
+title: ChatGPT + FastMCP
+sidebarTitle: ChatGPT
+description: Connect FastMCP servers to ChatGPT Deep Research
+icon: message-smile
+tag: NEW
+---
+
+ChatGPT supports MCP servers through remote HTTP connections, allowing you to extend ChatGPT's capabilities with custom tools and knowledge from your FastMCP servers.
+
+<Note>
+MCP integration with ChatGPT is currently limited to **Deep Research** functionality and is not available for general chat. This feature is available for ChatGPT Pro, Team, Enterprise, and Edu users.
+</Note>
+
+<Tip>
+OpenAI's official MCP documentation and examples are built with **FastMCP v2**! Check out their [sample MCP server](https://github.com/openai/mcp-server-sample) which demonstrates FastMCP in action.
+</Tip>
+
+## Deep Research
+
+ChatGPT's Deep Research feature requires MCP servers to be internet-accessible HTTP endpoints with **exactly two specific tools**:
+
+- **`search`**: For searching through your resources and returning matching IDs
+- **`fetch`**: For retrieving the full content of specific resources by ID
+
+<Warning>
+If your server doesn't implement both `search` and `fetch` tools with the correct signatures, ChatGPT will show the error: "This MCP server doesn't implement our specification". Both tools are required.
+</Warning>
+
+### Tool Descriptions Matter
+
+Since ChatGPT needs to understand how to use your tools effectively, **write detailed tool descriptions**. The description teaches ChatGPT how to form queries, what parameters to use, and what to expect from your data. Poor descriptions lead to poor search results.
+
+### Create a Server
+
+A Deep Research-compatible server must implement these two required tools:
+
+- **`search(query: str)`** - Takes a query of any kind and returns matching record IDs
+- **`fetch(id: str)`** - Takes an ID and returns the record
+
+**Critical**: Write detailed docstrings for both tools. These descriptions teach ChatGPT how to use your tools effectively. Poor descriptions lead to poor search results.
+
+The `search` tool should take a query (of any kind!) and return IDs. The `fetch` tool should take an ID and return the record.
+
+Here's a reference server implementation you can adapt (see also [OpenAI's sample server](https://github.com/openai/mcp-server-sample) for comparison):
+
+```python server.py [expandable]
+import json
+from pathlib import Path
+from dataclasses import dataclass
+from fastmcp import FastMCP
+
+@dataclass
+class Record:
+    id: str
+    title: str
+    text: str
+    metadata: dict
+
+def create_server(
+    records_path: Path | str,
+    name: str | None = None,
+    instructions: str | None = None,
+) -> FastMCP:
+    """Create a FastMCP server that can search and fetch records from a JSON file."""
+    records = json.loads(Path(records_path).read_text())
+
+    RECORDS = [Record(**r) for r in records]
+    LOOKUP = {r.id: r for r in RECORDS}
+
+    mcp = FastMCP(name=name or "Deep Research MCP", instructions=instructions)
+
+    @mcp.tool()
+    async def search(query: str):
+        """
+        Simple unranked keyword search across title, text, and metadata.
+        Searches for any of the query terms in the record content.
+        Returns a list of matching record IDs for ChatGPT to fetch.
+        """
+        toks = query.lower().split()
+        ids = []
+        for r in RECORDS:
+            record_txt = " ".join(
+                [r.title, r.text, " ".join(r.metadata.values())]
+            ).lower()
+            if any(t in record_txt for t in toks):
+                ids.append(r.id)
+
+        return {"ids": ids}
+
+    @mcp.tool()
+    async def fetch(id: str):
+        """
+        Fetch a record by ID.
+        Returns the complete record data for ChatGPT to analyze and cite.
+        """
+        if id not in LOOKUP:
+            raise ValueError(f"Unknown record ID: {id}")
+        return LOOKUP[id]
+
+    return mcp
+
+if __name__ == "__main__":
+    mcp = create_server("path/to/records.json")
+    mcp.run(transport="http", port=8000)
+```
+
+### Deploy the Server
+
+Your server must be deployed to a public URL in order for ChatGPT to access it.
+
+For development, you can use tools like `ngrok` to temporarily expose a locally-running server to the internet. We'll do that for this example (you may need to install `ngrok` and create a free account), but you can use any other method to deploy your server.
+
+Assuming you saved the above code as `server.py`, you can run the following two commands in two separate terminals to deploy your server and expose it to the internet:
+
+<CodeGroup>
+```bash FastMCP server
+python server.py
+```
+
+```bash ngrok
+ngrok http 8000
+```
+</CodeGroup>
+
+<Warning>
+This exposes your unauthenticated server to the internet. Only run this command in a safe environment if you understand the risks.
+</Warning>
+
+### Connect to ChatGPT
+
+Replace `https://your-server-url.com` with the actual URL of your server (such as your ngrok URL).
+
+1. Open ChatGPT and go to **Settings** → **Connectors**
+2. Click **Add custom connector**
+3. Enter your server details:
+   - **Name**: Library Catalog
+   - **URL**: Your server URL (e.g., `https://abc123.ngrok.io`)
+   - **Description**: A library catalog for searching and retrieving books
+
+#### Test the Connection
+
+1. Start a new chat in ChatGPT
+2. Click **Tools** → **Run deep research** 
+3. Select your **Library Catalog** connector as a source
+4. Ask questions like:
+   - "Search for Python programming books"
+   - "Find books about AI and machine learning"
+   - "Show me books by the Python Software Foundation"
+
+ChatGPT will use your server's search and fetch tools to find relevant information and cite the sources in its response.
+
+### Troubleshooting
+
+#### "This MCP server doesn't implement our specification"
+
+
+If you get this error, it most likely means that your server doesn't implement the required tools (`search` and `fetch`). To correct it, ensure that your server meets the service requirements.

docs/integrations/claude-code.mdx

@@ -0,0 +1,60 @@
+---
+title: Claude Code + FastMCP
+sidebarTitle: Claude Code
+description: Connect FastMCP servers to Claude Code
+icon: message-smile
+tag: NEW
+---
+
+Claude Code supports MCP servers through multiple transport methods, allowing you to extend Claude's capabilities with custom tools, resources, and prompts from your FastMCP servers.
+
+<Note>
+Claude Code supports both local and remote MCP servers with flexible configuration options. See the [Claude Code MCP documentation](https://docs.anthropic.com/en/docs/claude-code/mcp) for other transport methods.
+</Note>
+
+<Tip>
+Claude Code provides built-in MCP management commands to easily add, configure, and authenticate your FastMCP servers.
+</Tip>
+
+## Create a Server
+
+You can create FastMCP servers using STDIO transport, remote HTTP servers, or local HTTP servers. This example shows one common approach: running an HTTP server locally for development.
+
+```python server.py
+import random
+from fastmcp import FastMCP
+
+mcp = FastMCP(name="Dice Roller")
+
+@mcp.tool
+def roll_dice(n_dice: int) -> list[int]:
+    """Roll `n_dice` 6-sided dice and return the results."""
+    return [random.randint(1, 6) for _ in range(n_dice)]
+
+if __name__ == "__main__":
+    mcp.run(transport="http", port=8000)
+```
+
+## Connect to Claude Code
+
+Start your server and add it to Claude Code:
+
+```bash
+# Start your server first
+python server.py
+```
+
+Then add it to Claude Code:
+```bash
+claude mcp add dice --transport http http://localhost:8000/mcp/
+```
+
+## Using Your Server
+
+Once connected, Claude Code will automatically discover and use your server's tools when relevant:
+
+```
+Roll some dice for me
+```
+
+Claude will call your `roll_dice` tool and provide the results. If your server provides resources, you can reference them with `@` mentions like `@dice:file://path/to/resource`.

docs/integrations/claude-desktop.mdx

@@ -2,11 +2,15 @@
 title: Claude Desktop + FastMCP
 sidebarTitle: Claude Desktop
 description: Call FastMCP servers from Claude Desktop
-icon: desktop
+icon: message-smile
 ---
 
 
-Claude Desktop supports MCP servers through local STDIO connections, allowing you to extend Claude's capabilities with custom tools, resources, and prompts from your FastMCP servers.
+Claude Desktop supports MCP servers through local STDIO connections and remote servers (beta), allowing you to extend Claude's capabilities with custom tools, resources, and prompts from your FastMCP servers.
+
+<Note>
+Remote MCP server support is currently in beta and available for users on Claude Pro, Max, Team, and Enterprise plans (as of June 2025). Most users will still need to use local STDIO connections.
+</Note>
 
 <Note>
 This guide focuses specifically on using FastMCP servers with Claude Desktop. For general Claude Desktop MCP setup and official examples, see the [official Claude Desktop quickstart guide](https://modelcontextprotocol.io/quickstart/user).
@@ -15,10 +19,10 @@ This guide focuses specifically on using FastMCP servers with Claude Desktop. Fo
 
 ## Requirements
 
-Claude Desktop requires MCP servers to run locally using STDIO transport. This means your server will communicate with Claude through standard input/output rather than HTTP.
+Claude Desktop traditionally requires MCP servers to run locally using STDIO transport, where your server communicates with Claude through standard input/output rather than HTTP. However, users on certain plans now have access to remote server support as well.
 
 <Tip>
-If you need to connect to remote servers, you can create a **proxy server** that runs locally via STDIO and forwards requests to remote HTTP servers. See the [Proxy Servers](#proxy-servers) section below.
+If you don't have access to remote server support or need to connect to remote servers, you can create a **proxy server** that runs locally via STDIO and forwards requests to remote HTTP servers. See the [Proxy Servers](#proxy-servers) section below.
 </Tip>
 
 ## Create a Server
@@ -181,7 +185,7 @@ Claude Desktop runs servers in a completely isolated environment with no access
 ## Remote Servers
 
 
-Claude Desktop only supports local STDIO servers, but FastMCP can create a proxy server that forwards requests to a remote HTTP server. You can install the proxy server in Claude Desktop.
+Users on Claude Pro, Max, Team, and Enterprise plans have first-class remote server support via integrations. For other users, or as an alternative approach, FastMCP can create a proxy server that forwards requests to a remote HTTP server. You can install the proxy server in Claude Desktop.
 
 Create a proxy server that connects to a remote HTTP server:
 

docs/integrations/gemini.mdx

@@ -99,7 +99,7 @@ from fastmcp import Client
 from fastmcp.client.auth import BearerAuth
 
 mcp_client = Client(
-    "https://my-server.com/sse",
+    "https://my-server.com/mcp/",
     auth=BearerAuth("<your-token>"),
 )
 ```

docs/integrations/openai.mdx

@@ -38,7 +38,7 @@ def roll_dice(n_dice: int) -> list[int]:
     return [random.randint(1, 6) for _ in range(n_dice)]
 
 if __name__ == "__main__":
-    mcp.run(transport="sse", port=8000)
+    mcp.run(transport="http", port=8000)
 ```
 
 ### Deploy the Server
@@ -77,7 +77,7 @@ You'll also need to authenticate with OpenAI. You can do this by setting the `OP
 export OPENAI_API_KEY="your-api-key"
 ```
 
-Here is an example of how to call your server from Python. Note that you'll need to replace `https://your-server-url.com` with the actual URL of your server. In addition, we use `/sse` as the endpoint because we deployed an SSE server with the default path; you may need to use a different endpoint if you customized your server's deployment.
+Here is an example of how to call your server from Python. Note that you'll need to replace `https://your-server-url.com` with the actual URL of your server. In addition, we use `/mcp/` as the endpoint because we deployed a streamable-HTTP server with the default path; you may need to use a different endpoint if you customized your server's deployment.
 
 ```python {4, 11-16}
 from openai import OpenAI
@@ -93,7 +93,7 @@ resp = client.responses.create(
         {
             "type": "mcp",
             "server_label": "dice_server",
-            "server_url": f"{url}/sse",
+            "server_url": f"{url}/mcp/",
             "require_approval": "never",
         },
     ],
@@ -172,7 +172,7 @@ def roll_dice(n_dice: int) -> list[int]:
 
 if __name__ == "__main__":
     print(f"\n---\n\n🔑 Dice Roller access token:\n\n{access_token}\n\n---\n")
-    mcp.run(transport="sse", port=8000)
+    mcp.run(transport="http", port=8000)
 ```
 
 #### Client Authentication
@@ -212,7 +212,7 @@ resp = client.responses.create(
         {
             "type": "mcp",
             "server_label": "dice_server",
-            "server_url": f"{url}/sse",
+            "server_url": f"{url}/mcp/",
             "require_approval": "never",
             "headers": {
                 "Authorization": f"Bearer {access_token}"

docs/patterns/cli.mdx

@@ -42,11 +42,12 @@ This command runs the server directly in your current Python environment. You ar
 
 | Option | Flag | Description |
 | ------ | ---- | ----------- |
-| Transport | `--transport`, `-t` | Transport protocol to use (`stdio`, `streamable-http`, or `sse`) |
+| Transport | `--transport`, `-t` | Transport protocol to use (`stdio`, `http`, or `sse`) |
 | Host | `--host` | Host to bind to when using http transport (default: 127.0.0.1) |
 | Port | `--port`, `-p` | Port to bind to when using http transport (default: 8000) |
 | Log Level | `--log-level`, `-l` | Log level (DEBUG, INFO, WARNING, ERROR, CRITICAL) |
 
+
 #### Server Specification
 <VersionBadge version="2.3.5" />
 
@@ -79,14 +80,14 @@ if __name__ == "__main__":
 You can run it with Streamable HTTP transport regardless of what's in the `__main__` block:
 
 ```bash
-fastmcp run server.py --transport streamable-http --port 8000
+fastmcp run server.py --transport http --port 8000
 ```
 
 **Examples**
 
 ```bash
 # Run a local server with Streamable HTTP transport on a custom port
-fastmcp run server.py --transport streamable-http --port 8000
+fastmcp run server.py --transport http --port 8000
 
 # Connect to a remote server and proxy as a stdio server
 fastmcp run https://example.com/mcp-server
@@ -112,14 +113,14 @@ The `dev` command is a shortcut for testing a server over STDIO only. When the I
 1. Select "STDIO" from the transport dropdown
 2. Connect manually
 
-This command does not support HTTP testing. To test a server over HTTP:
-1. Start your server manually with HTTP transport using either:
+This command does not support HTTP testing. To test a server over Streamable HTTP or SSE:
+1. Start your server manually with the appropriate transport using either the command line:
    ```bash
-   fastmcp run server.py --transport streamable-http
+   fastmcp run server.py --transport http
    ```
-   or
+   or by setting the transport in your code:
    ```bash
-   python server.py  # Assuming your __main__ block sets HTTP transport
+   python server.py  # Assuming your __main__ block sets Streamable HTTP transport
    ```
 2. Open the MCP Inspector separately and connect to your running server
 </Warning>

docs/python-sdk/fastmcp-cli-claude.mdx

@@ -10,7 +10,7 @@ Claude app integration utilities.
 
 ## Functions
 
-### `get_claude_config_path`
+### `get_claude_config_path` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/cli/claude.py#L14"><Icon icon="github" size="14" /></a></sup>
 
 ```python
 get_claude_config_path() -> Path | None
@@ -20,7 +20,7 @@ get_claude_config_path() -> Path | None
 Get the Claude config directory based on platform.
 
 
-### `update_claude_config`
+### `update_claude_config` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/cli/claude.py#L32"><Icon icon="github" size="14" /></a></sup>
 
 ```python
 update_claude_config(file_spec: str, server_name: str) -> bool

docs/python-sdk/fastmcp-cli-cli.mdx

@@ -10,13 +10,13 @@ FastMCP CLI tools.
 
 ## Functions
 
-### `version`
+### `version` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/cli/cli.py#L87"><Icon icon="github" size="14" /></a></sup>
 
 ```python
 version(ctx: Context)
 ```
 
-### `dev`
+### `dev` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/cli/cli.py#L110"><Icon icon="github" size="14" /></a></sup>
 
 ```python
 dev(server_spec: str = typer.Argument(..., help='Python file to run, optionally with :object suffix'), with_editable: Annotated[Path | None, typer.Option('--with-editable', '-e', help='Directory containing pyproject.toml to install in editable mode', exists=True, file_okay=False, resolve_path=True)] = None, with_packages: Annotated[list[str], typer.Option('--with', help='Additional packages to install')] = [], inspector_version: Annotated[str | None, typer.Option('--inspector-version', help='Version of the MCP Inspector to use')] = None, ui_port: Annotated[int | None, typer.Option('--ui-port', help='Port for the MCP Inspector UI')] = None, server_port: Annotated[int | None, typer.Option('--server-port', help='Port for the MCP Inspector Proxy server')] = None) -> None
@@ -26,10 +26,10 @@ dev(server_spec: str = typer.Argument(..., help='Python file to run, optionally
 Run a MCP server with the MCP Inspector.
 
 
-### `run`
+### `run` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/cli/cli.py#L227"><Icon icon="github" size="14" /></a></sup>
 
 ```python
-run(ctx: typer.Context, server_spec: str = typer.Argument(..., help='Python file, object specification (file:obj), or URL'), transport: Annotated[str | None, typer.Option('--transport', '-t', help='Transport protocol to use (stdio, streamable-http, or sse)')] = None, host: Annotated[str | None, typer.Option('--host', help='Host to bind to when using http transport (default: 127.0.0.1)')] = None, port: Annotated[int | None, typer.Option('--port', '-p', help='Port to bind to when using http transport (default: 8000)')] = None, log_level: Annotated[str | None, typer.Option('--log-level', '-l', help='Log level (DEBUG, INFO, WARNING, ERROR, CRITICAL)')] = None) -> None
+run(ctx: typer.Context, server_spec: str = typer.Argument(..., help='Python file, object specification (file:obj), or URL'), transport: Annotated[str | None, typer.Option('--transport', '-t', help='Transport protocol to use (stdio, http, or sse)')] = None, host: Annotated[str | None, typer.Option('--host', help='Host to bind to when using http transport (default: 127.0.0.1)')] = None, port: Annotated[int | None, typer.Option('--port', '-p', help='Port to bind to when using http transport (default: 8000)')] = None, log_level: Annotated[str | None, typer.Option('--log-level', '-l', help='Log level (DEBUG, INFO, WARNING, ERROR, CRITICAL)')] = None) -> None
 ```
 
 
@@ -51,7 +51,7 @@ Server arguments can be passed after -- :
 fastmcp run server.py -- --config config.json --debug
 
 
-### `install`
+### `install` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/cli/cli.py#L313"><Icon icon="github" size="14" /></a></sup>
 
 ```python
 install(server_spec: str = typer.Argument(..., help='Python file to run, optionally with :object suffix'), server_name: Annotated[str | None, typer.Option('--name', '-n', help="Custom name for the server (defaults to server's name attribute or file name)")] = None, with_editable: Annotated[Path | None, typer.Option('--with-editable', '-e', help='Directory containing pyproject.toml to install in editable mode', exists=True, file_okay=False, resolve_path=True)] = None, with_packages: Annotated[list[str], typer.Option('--with', help='Additional packages to install')] = [], env_vars: Annotated[list[str], typer.Option('--env-var', '-v', help='Environment variables in KEY=VALUE format')] = [], env_file: Annotated[Path | None, typer.Option('--env-file', '-f', help='Load environment variables from a .env file', exists=True, file_okay=True, dir_okay=False, resolve_path=True)] = None) -> None
@@ -63,3 +63,25 @@ Install a MCP server in the Claude desktop app.
 Environment variables are preserved once added and only updated if new values
 are explicitly provided.
 
+
+### `inspect` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/cli/cli.py#L444"><Icon icon="github" size="14" /></a></sup>
+
+```python
+inspect(server_spec: str = typer.Argument(..., help='Python file to inspect, optionally with :object suffix'), output: Annotated[Path, typer.Option('--output', '-o', help='Output file path for the JSON report (default: server-info.json)')] = Path('server-info.json')) -> None
+```
+
+
+Inspect a FastMCP server and generate a JSON report.
+
+This command analyzes a FastMCP server (v1.x or v2.x) and generates
+a comprehensive JSON report containing information about the server's
+name, instructions, version, tools, prompts, resources, templates,
+and capabilities.
+
+**Examples:**
+
+fastmcp inspect server.py
+fastmcp inspect server.py -o report.json
+fastmcp inspect server.py:mcp -o analysis.json
+fastmcp inspect path/to/server.py:app -o /tmp/server-info.json
+

docs/python-sdk/fastmcp-cli-run.mdx

@@ -10,7 +10,7 @@ FastMCP run command implementation.
 
 ## Functions
 
-### `is_url`
+### `is_url` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/cli/run.py#L14"><Icon icon="github" size="14" /></a></sup>
 
 ```python
 is_url(path: str) -> bool
@@ -20,7 +20,7 @@ is_url(path: str) -> bool
 Check if a string is a URL.
 
 
-### `parse_file_path`
+### `parse_file_path` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/cli/run.py#L20"><Icon icon="github" size="14" /></a></sup>
 
 ```python
 parse_file_path(server_spec: str) -> tuple[Path, str | None]
@@ -36,7 +36,7 @@ Parse a file path that may include a server object specification.
 - Tuple of (file_path, server_object)
 
 
-### `import_server`
+### `import_server` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/cli/run.py#L51"><Icon icon="github" size="14" /></a></sup>
 
 ```python
 import_server(file: Path, server_object: str | None = None) -> Any
@@ -53,7 +53,7 @@ Import a MCP server from a file.
 - The server object
 
 
-### `create_client_server`
+### `create_client_server` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/cli/run.py#L121"><Icon icon="github" size="14" /></a></sup>
 
 ```python
 create_client_server(url: str) -> Any
@@ -69,7 +69,7 @@ Create a FastMCP server from a client URL.
 - A FastMCP server instance
 
 
-### `import_server_with_args`
+### `import_server_with_args` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/cli/run.py#L141"><Icon icon="github" size="14" /></a></sup>
 
 ```python
 import_server_with_args(file: Path, server_object: str | None = None, server_args: list[str] | None = None) -> Any
@@ -87,7 +87,7 @@ Import a server with optional command line arguments.
 - The imported server object
 
 
-### `run_command`
+### `run_command` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/cli/run.py#L165"><Icon icon="github" size="14" /></a></sup>
 
 ```python
 run_command(server_spec: str, transport: str | None = None, host: str | None = None, port: int | None = None, log_level: str | None = None, server_args: list[str] | None = None) -> None

docs/python-sdk/fastmcp-client-auth-bearer.mdx

@@ -7,11 +7,11 @@ sidebarTitle: bearer
 
 ## Classes
 
-### `BearerAuth`
+### `BearerAuth` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/client/auth/bearer.py#L11"><Icon icon="github" size="14" /></a></sup>
 
 **Methods:**
 
-#### `auth_flow`
+#### `auth_flow` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/client/auth/bearer.py#L15"><Icon icon="github" size="14" /></a></sup>
 
 ```python
 auth_flow(self, request)

docs/python-sdk/fastmcp-client-auth-oauth.mdx

@@ -7,13 +7,13 @@ sidebarTitle: oauth
 
 ## Functions
 
-### `default_cache_dir`
+### `default_cache_dir` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/client/auth/oauth.py#L38"><Icon icon="github" size="14" /></a></sup>
 
 ```python
 default_cache_dir() -> Path
 ```
 
-### `OAuth`
+### `OAuth` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/client/auth/oauth.py#L295"><Icon icon="github" size="14" /></a></sup>
 
 ```python
 OAuth(mcp_url: str, scopes: str | list[str] | None = None, client_name: str = 'FastMCP Client', token_storage_cache_dir: Path | None = None, additional_client_metadata: dict[str, Any] | None = None) -> _MCPOAuthClientProvider
@@ -38,7 +38,7 @@ httpx.AsyncClient (or appropriate FastMCP client/transport instance)
 
 ## Classes
 
-### `ServerOAuthMetadata`
+### `ServerOAuthMetadata` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/client/auth/oauth.py#L43"><Icon icon="github" size="14" /></a></sup>
 
 
 More flexible OAuth metadata model that accepts broader ranges of values
@@ -48,13 +48,13 @@ This handles real-world OAuth servers like PayPal that may support
 additional methods not in the MCP specification.
 
 
-### `OAuthClientProvider`
+### `OAuthClientProvider` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/client/auth/oauth.py#L68"><Icon icon="github" size="14" /></a></sup>
 
 
 OAuth client provider with more flexible OAuth metadata discovery.
 
 
-### `FileTokenStorage`
+### `FileTokenStorage` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/client/auth/oauth.py#L116"><Icon icon="github" size="14" /></a></sup>
 
 
 File-based token storage implementation for OAuth credentials and tokens.
@@ -65,7 +65,7 @@ Each instance is tied to a specific server URL for proper token isolation.
 
 **Methods:**
 
-#### `get_base_url`
+#### `get_base_url` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/client/auth/oauth.py#L131"><Icon icon="github" size="14" /></a></sup>
 
 ```python
 get_base_url(url: str) -> str
@@ -74,7 +74,7 @@ get_base_url(url: str) -> str
 Extract the base URL (scheme + host) from a URL.
 
 
-#### `get_cache_key`
+#### `get_cache_key` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/client/auth/oauth.py#L136"><Icon icon="github" size="14" /></a></sup>
 
 ```python
 get_cache_key(self) -> str
@@ -83,7 +83,7 @@ get_cache_key(self) -> str
 Generate a safe filesystem key from the server's base URL.
 
 
-#### `clear`
+#### `clear` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/client/auth/oauth.py#L208"><Icon icon="github" size="14" /></a></sup>
 
 ```python
 clear(self) -> None
@@ -92,7 +92,7 @@ clear(self) -> None
 Clear all cached data for this server.
 
 
-#### `clear_all`
+#### `clear_all` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/client/auth/oauth.py#L217"><Icon icon="github" size="14" /></a></sup>
 
 ```python
 clear_all(cls, cache_dir: Path | None = None) -> None

docs/python-sdk/fastmcp-client-client.mdx

@@ -7,48 +7,48 @@ sidebarTitle: client
 
 ## Classes
 
-### `Client`
-
-
-
-    MCP client that delegates connection management to a Transport instance.
-
-    The Client class is responsible for MCP protocol logic, while the Transport
-    handles connection establishment and management. Client provides methods for
-    working with resources, prompts, tools and other MCP capabilities.
-
-    Args:
-        transport: Connection source specification, which can be:
-            - ClientTransport: Direct transport instance
-            - FastMCP: In-process FastMCP server
-            - AnyUrl | str: URL to connect to
-            - Path: File path for local socket
-            - MCPConfig: MCP server configuration
-            - dict: Transport configuration
-        roots: Optional RootsList or RootsHandler for filesystem access
-        sampling_handler: Optional handler for sampling requests
-        log_handler: Optional handler for log messages
-        message_handler: Optional handler for protocol messages
-        progress_handler: Optional handler for progress notifications
-        timeout: Optional timeout for requests (seconds or timedelta)
-        init_timeout: Optional timeout for initial connection (seconds or timedelta).
-            Set to 0 to disable. If None, uses the value in the FastMCP global settings.
-
-    Examples:
-        ```python # Connect to FastMCP server client =
-        Client("http://localhost:8080")
-
-        async with client:
-            # List available resources resources = await client.list_resources()
+### `Client` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/client/client.py#L60"><Icon icon="github" size="14" /></a></sup>
+
+
+MCP client that delegates connection management to a Transport instance.
+
+The Client class is responsible for MCP protocol logic, while the Transport
+handles connection establishment and management. Client provides methods for
+working with resources, prompts, tools and other MCP capabilities.
+
+**Args:**
+- `transport`: Connection source specification, which can be\:
+- ClientTransport\: Direct transport instance
+- FastMCP\: In-process FastMCP server
+- AnyUrl | str\: URL to connect to
+- Path\: File path for local socket
+- MCPConfig\: MCP server configuration
+- dict\: Transport configuration
+- `roots`: Optional RootsList or RootsHandler for filesystem access
+- `sampling_handler`: Optional handler for sampling requests
+- `log_handler`: Optional handler for log messages
+- `message_handler`: Optional handler for protocol messages
+- `progress_handler`: Optional handler for progress notifications
+- `timeout`: Optional timeout for requests (seconds or timedelta)
+- `init_timeout`: Optional timeout for initial connection (seconds or timedelta).
+Set to 0 to disable. If None, uses the value in the FastMCP global settings.
+
+**Examples:**
+
+```python # Connect to FastMCP server client =
+Client("http://localhost:8080")
+
+async with client:
+    # List available resources resources = await client.list_resources()
+
+    # Call a tool result = await client.call_tool("my_tool", {"param":
+    "value"})
+```
 
-            # Call a tool result = await client.call_tool("my_tool", {"param":
-            "value"})
-        ```
-    
 
 **Methods:**
 
-#### `session`
+#### `session` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/client/client.py#L207"><Icon icon="github" size="14" /></a></sup>
 
 ```python
 session(self) -> ClientSession
@@ -57,7 +57,7 @@ session(self) -> ClientSession
 Get the current active session. Raises RuntimeError if not connected.
 
 
-#### `initialize_result`
+#### `initialize_result` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/client/client.py#L217"><Icon icon="github" size="14" /></a></sup>
 
 ```python
 initialize_result(self) -> mcp.types.InitializeResult
@@ -66,7 +66,7 @@ initialize_result(self) -> mcp.types.InitializeResult
 Get the result of the initialization request.
 
 
-#### `set_roots`
+#### `set_roots` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/client/client.py#L225"><Icon icon="github" size="14" /></a></sup>
 
 ```python
 set_roots(self, roots: RootsList | RootsHandler) -> None
@@ -75,7 +75,7 @@ set_roots(self, roots: RootsList | RootsHandler) -> None
 Set the roots for the client. This does not automatically call `send_roots_list_changed`.
 
 
-#### `set_sampling_callback`
+#### `set_sampling_callback` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/client/client.py#L229"><Icon icon="github" size="14" /></a></sup>
 
 ```python
 set_sampling_callback(self, sampling_callback: SamplingHandler) -> None
@@ -84,7 +84,7 @@ set_sampling_callback(self, sampling_callback: SamplingHandler) -> None
 Set the sampling callback for the client.
 
 
-#### `is_connected`
+#### `is_connected` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/client/client.py#L235"><Icon icon="github" size="14" /></a></sup>
 
 ```python
 is_connected(self) -> bool

docs/python-sdk/fastmcp-client-logging.mdx

@@ -7,7 +7,7 @@ sidebarTitle: logging
 
 ## Functions
 
-### `create_log_callback`
+### `create_log_callback` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/client/logging.py#L20"><Icon icon="github" size="14" /></a></sup>
 
 ```python
 create_log_callback(handler: LogHandler | None = None) -> LoggingFnT

docs/python-sdk/fastmcp-client-oauth_callback.mdx

@@ -15,7 +15,7 @@ and display styled responses to users.
 
 ## Functions
 
-### `create_callback_html`
+### `create_callback_html` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/client/oauth_callback.py#L25"><Icon icon="github" size="14" /></a></sup>
 
 ```python
 create_callback_html(message: str, is_success: bool = True, title: str = 'FastMCP OAuth', server_url: str | None = None) -> str
@@ -25,7 +25,7 @@ create_callback_html(message: str, is_success: bool = True, title: str = 'FastMC
 Create a styled HTML response for OAuth callbacks.
 
 
-### `create_oauth_callback_server`
+### `create_oauth_callback_server` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/client/oauth_callback.py#L197"><Icon icon="github" size="14" /></a></sup>
 
 ```python
 create_oauth_callback_server(port: int, callback_path: str = '/callback', server_url: str | None = None, response_future: asyncio.Future | None = None) -> Server
@@ -46,17 +46,17 @@ Create an OAuth callback server.
 
 ## Classes
 
-### `CallbackResponse`
+### `CallbackResponse` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/client/oauth_callback.py#L183"><Icon icon="github" size="14" /></a></sup>
 
 **Methods:**
 
-#### `from_dict`
+#### `from_dict` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/client/oauth_callback.py#L190"><Icon icon="github" size="14" /></a></sup>
 
 ```python
 from_dict(cls, data: dict[str, str]) -> CallbackResponse
 ```
 
-#### `to_dict`
+#### `to_dict` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/client/oauth_callback.py#L193"><Icon icon="github" size="14" /></a></sup>
 
 ```python
 to_dict(self) -> dict[str, str]

docs/python-sdk/fastmcp-client-roots.mdx

@@ -7,13 +7,13 @@ sidebarTitle: roots
 
 ## Functions
 
-### `convert_roots_list`
+### `convert_roots_list` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/client/roots.py#L19"><Icon icon="github" size="14" /></a></sup>
 
 ```python
 convert_roots_list(roots: RootsList) -> list[mcp.types.Root]
 ```
 
-### `create_roots_callback`
+### `create_roots_callback` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/client/roots.py#L33"><Icon icon="github" size="14" /></a></sup>
 
 ```python
 create_roots_callback(handler: RootsList | RootsHandler) -> ListRootsFnT

docs/python-sdk/fastmcp-client-sampling.mdx

@@ -7,7 +7,7 @@ sidebarTitle: sampling
 
 ## Functions
 
-### `create_sampling_callback`
+### `create_sampling_callback` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/client/sampling.py#L25"><Icon icon="github" size="14" /></a></sup>
 
 ```python
 create_sampling_callback(sampling_handler: SamplingHandler) -> SamplingFnT

docs/python-sdk/fastmcp-client-transports.mdx

@@ -7,63 +7,63 @@ sidebarTitle: transports
 
 ## Functions
 
-### `infer_transport`
+### `infer_transport` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/client/transports.py#L837"><Icon icon="github" size="14" /></a></sup>
 
 ```python
 infer_transport(transport: ClientTransport | FastMCP | FastMCP1Server | AnyUrl | Path | MCPConfig | dict[str, Any] | str) -> ClientTransport
 ```
 
 
+Infer the appropriate transport type from the given transport argument.
 
-    Infer the appropriate transport type from the given transport argument.
+This function attempts to infer the correct transport type from the provided
+argument, handling various input types and converting them to the appropriate
+ClientTransport subclass.
 
-    This function attempts to infer the correct transport type from the provided
-    argument, handling various input types and converting them to the appropriate
-    ClientTransport subclass.
+The function supports these input types:
+- ClientTransport: Used directly without modification
+- FastMCP or FastMCP1Server: Creates an in-memory FastMCPTransport
+- Path or str (file path): Creates PythonStdioTransport (.py) or NodeStdioTransport (.js)
+- AnyUrl or str (URL): Creates StreamableHttpTransport (default) or SSETransport (for /sse endpoints)
+- MCPConfig or dict: Creates MCPConfigTransport, potentially connecting to multiple servers
 
-    The function supports these input types:
-    - ClientTransport: Used directly without modification
-    - FastMCP or FastMCP1Server: Creates an in-memory FastMCPTransport
-    - Path or str (file path): Creates PythonStdioTransport (.py) or NodeStdioTransport (.js)
-    - AnyUrl or str (URL): Creates StreamableHttpTransport (default) or SSETransport (for /sse endpoints)
-    - MCPConfig or dict: Creates MCPConfigTransport, potentially connecting to multiple servers
+For HTTP URLs, they are assumed to be Streamable HTTP URLs unless they end in `/sse`.
 
-    For HTTP URLs, they are assumed to be Streamable HTTP URLs unless they end in `/sse`.
+For MCPConfig with multiple servers, a composite client is created where each server
+is mounted with its name as prefix. This allows accessing tools and resources from multiple
+servers through a single unified client interface, using naming patterns like
+`servername_toolname` for tools and `protocol://servername/path` for resources.
+If the MCPConfig contains only one server, a direct connection is established without prefixing.
 
-    For MCPConfig with multiple servers, a composite client is created where each server
-    is mounted with its name as prefix. This allows accessing tools and resources from multiple
-    servers through a single unified client interface, using naming patterns like
-    `servername_toolname` for tools and `protocol://servername/path` for resources.
-    If the MCPConfig contains only one server, a direct connection is established without prefixing.
+**Examples:**
 
-    Examples:
-        ```python
-        # Connect to a local Python script
-        transport = infer_transport("my_script.py")
-
-        # Connect to a remote server via HTTP
-        transport = infer_transport("http://example.com/mcp")
+```python
+# Connect to a local Python script
+transport = infer_transport("my_script.py")
+
+# Connect to a remote server via HTTP
+transport = infer_transport("http://example.com/mcp")
+
+# Connect to multiple servers using MCPConfig
+config = {
+    "mcpServers": {
+        "weather": {"url": "http://weather.example.com/mcp"},
+        "calendar": {"url": "http://calendar.example.com/mcp"}
+    }
+}
+transport = infer_transport(config)
+```
 
-        # Connect to multiple servers using MCPConfig
-        config = {
-            "mcpServers": {
-                "weather": {"url": "http://weather.example.com/mcp"},
-                "calendar": {"url": "http://calendar.example.com/mcp"}
-            }
-        }
-        transport = infer_transport(config)
-        ```
-    
 
 ## Classes
 
-### `SessionKwargs`
+### `SessionKwargs` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/client/transports.py#L52"><Icon icon="github" size="14" /></a></sup>
 
 
 Keyword arguments for the MCP ClientSession constructor.
 
 
-### `ClientTransport`
+### `ClientTransport` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/client/transports.py#L63"><Icon icon="github" size="14" /></a></sup>
 
 
 Abstract base class for different MCP client transport mechanisms.
@@ -72,25 +72,25 @@ A Transport is responsible for establishing and managing connections
 to an MCP server, and providing a ClientSession within an async context.
 
 
-### `WSTransport`
+### `WSTransport` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/client/transports.py#L109"><Icon icon="github" size="14" /></a></sup>
 
 
 Transport implementation that connects to an MCP server via WebSockets.
 
 
-### `SSETransport`
+### `SSETransport` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/client/transports.py#L148"><Icon icon="github" size="14" /></a></sup>
 
 
 Transport implementation that connects to an MCP server via Server-Sent Events.
 
 
-### `StreamableHttpTransport`
+### `StreamableHttpTransport` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/client/transports.py#L223"><Icon icon="github" size="14" /></a></sup>
 
 
 Transport implementation that connects to an MCP server via Streamable HTTP Requests.
 
 
-### `StdioTransport`
+### `StdioTransport` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/client/transports.py#L299"><Icon icon="github" size="14" /></a></sup>
 
 
 Base transport for connecting to an MCP server via subprocess with stdio.
@@ -99,37 +99,37 @@ This is a base class that can be subclassed for specific command-based
 transports like Python, Node, Uvx, etc.
 
 
-### `PythonStdioTransport`
+### `PythonStdioTransport` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/client/transports.py#L416"><Icon icon="github" size="14" /></a></sup>
 
 
 Transport for running Python scripts.
 
 
-### `FastMCPStdioTransport`
+### `FastMCPStdioTransport` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/client/transports.py#L462"><Icon icon="github" size="14" /></a></sup>
 
 
 Transport for running FastMCP servers using the FastMCP CLI.
 
 
-### `NodeStdioTransport`
+### `NodeStdioTransport` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/client/transports.py#L489"><Icon icon="github" size="14" /></a></sup>
 
 
 Transport for running Node.js scripts.
 
 
-### `UvxStdioTransport`
+### `UvxStdioTransport` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/client/transports.py#L531"><Icon icon="github" size="14" /></a></sup>
 
 
 Transport for running commands via the uvx tool.
 
 
-### `NpxStdioTransport`
+### `NpxStdioTransport` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/client/transports.py#L597"><Icon icon="github" size="14" /></a></sup>
 
 
 Transport for running commands via the npx tool.
 
 
-### `FastMCPTransport`
+### `FastMCPTransport` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/client/transports.py#L659"><Icon icon="github" size="14" /></a></sup>
 
 
 In-memory transport for FastMCP servers.
@@ -140,52 +140,53 @@ servers from the low-level MCP SDK. This is particularly useful for unit
 tests or scenarios where client and server run in the same runtime.
 
 
-### `MCPConfigTransport`
+### `MCPConfigTransport` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/client/transports.py#L713"><Icon icon="github" size="14" /></a></sup>
 
 
 Transport for connecting to one or more MCP servers defined in an MCPConfig.
 
-    This transport provides a unified interface to multiple MCP servers defined in an MCPConfig
-    object or dictionary matching the MCPConfig schema. It supports two key scenarios:
-
-    1. If the MCPConfig contains exactly one server, it creates a direct transport to that server.
-    2. If the MCPConfig contains multiple servers, it creates a composite client by mounting
-       all servers on a single FastMCP instance, with each server's name used as its mounting prefix.
-
-    In the multi-server case, tools are accessible with the prefix pattern `{server_name}_{tool_name}`
-    and resources with the pattern `protocol://{server_name}/path/to/resource`.
-
-    This is particularly useful for creating clients that need to interact with multiple specialized
-    MCP servers through a single interface, simplifying client code.
-
-    Examples:
-        ```python
-        from fastmcp import Client
-        from fastmcp.utilities.mcp_config import MCPConfig
-
-        # Create a config with multiple servers
-        config = {
-            "mcpServers": {
-                "weather": {
-                    "url": "https://weather-api.example.com/mcp",
-                    "transport": "streamable-http"
-                },
-                "calendar": {
-                    "url": "https://calendar-api.example.com/mcp",
-                    "transport": "streamable-http"
-                }
-            }
+This transport provides a unified interface to multiple MCP servers defined in an MCPConfig
+object or dictionary matching the MCPConfig schema. It supports two key scenarios:
+
+1. If the MCPConfig contains exactly one server, it creates a direct transport to that server.
+2. If the MCPConfig contains multiple servers, it creates a composite client by mounting
+   all servers on a single FastMCP instance, with each server's name used as its mounting prefix.
+
+In the multi-server case, tools are accessible with the prefix pattern `{server_name}_{tool_name}`
+and resources with the pattern `protocol://{server_name}/path/to/resource`.
+
+This is particularly useful for creating clients that need to interact with multiple specialized
+MCP servers through a single interface, simplifying client code.
+
+**Examples:**
+
+```python
+from fastmcp import Client
+from fastmcp.utilities.mcp_config import MCPConfig
+
+# Create a config with multiple servers
+config = {
+    "mcpServers": {
+        "weather": {
+            "url": "https://weather-api.example.com/mcp",
+            "transport": "http"
+        },
+        "calendar": {
+            "url": "https://calendar-api.example.com/mcp",
+            "transport": "http"
         }
+    }
+}
+
+# Create a client with the config
+client = Client(config)
 
-        # Create a client with the config
-        client = Client(config)
+async with client:
+    # Access tools with prefixes
+    weather = await client.call_tool("weather_get_forecast", {"city": "London"})
+    events = await client.call_tool("calendar_list_events", {"date": "2023-06-01"})
 
-        async with client:
-            # Access tools with prefixes
-            weather = await client.call_tool("weather_get_forecast", {"city": "London"})
-            events = await client.call_tool("calendar_list_events", {"date": "2023-06-01"})
+    # Access resources with prefixed URIs
+    icons = await client.read_resource("weather://weather/icons/sunny")
+```
 
-            # Access resources with prefixed URIs
-            icons = await client.read_resource("weather://weather/icons/sunny")
-        ```
-    

docs/python-sdk/fastmcp-exceptions.mdx

@@ -10,55 +10,55 @@ Custom exceptions for FastMCP.
 
 ## Classes
 
-### `FastMCPError`
+### `FastMCPError` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/exceptions.py#L6"><Icon icon="github" size="14" /></a></sup>
 
 
 Base error for FastMCP.
 
 
-### `ValidationError`
+### `ValidationError` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/exceptions.py#L10"><Icon icon="github" size="14" /></a></sup>
 
 
 Error in validating parameters or return values.
 
 
-### `ResourceError`
+### `ResourceError` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/exceptions.py#L14"><Icon icon="github" size="14" /></a></sup>
 
 
 Error in resource operations.
 
 
-### `ToolError`
+### `ToolError` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/exceptions.py#L18"><Icon icon="github" size="14" /></a></sup>
 
 
 Error in tool operations.
 
 
-### `PromptError`
+### `PromptError` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/exceptions.py#L22"><Icon icon="github" size="14" /></a></sup>
 
 
 Error in prompt operations.
 
 
-### `InvalidSignature`
+### `InvalidSignature` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/exceptions.py#L26"><Icon icon="github" size="14" /></a></sup>
 
 
 Invalid signature for use with FastMCP.
 
 
-### `ClientError`
+### `ClientError` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/exceptions.py#L30"><Icon icon="github" size="14" /></a></sup>
 
 
 Error in client operations.
 
 
-### `NotFoundError`
+### `NotFoundError` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/exceptions.py#L34"><Icon icon="github" size="14" /></a></sup>
 
 
 Object not found.
 
 
-### `DisabledError`
+### `DisabledError` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/exceptions.py#L38"><Icon icon="github" size="14" /></a></sup>
 
 
 Object is disabled.

docs/python-sdk/fastmcp-prompts-prompt.mdx

@@ -10,7 +10,7 @@ Base classes for FastMCP prompts.
 
 ## Functions
 
-### `Message`
+### `Message` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/prompts/prompt.py#L32"><Icon icon="github" size="14" /></a></sup>
 
 ```python
 Message(content: str | MCPContent, role: Role | None = None, **kwargs: Any) -> PromptMessage
@@ -22,13 +22,13 @@ A user-friendly constructor for PromptMessage.
 
 ## Classes
 
-### `PromptArgument`
+### `PromptArgument` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/prompts/prompt.py#L54"><Icon icon="github" size="14" /></a></sup>
 
 
 An argument that can be passed to a prompt.
 
 
-### `Prompt`
+### `Prompt` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/prompts/prompt.py#L66"><Icon icon="github" size="14" /></a></sup>
 
 
 A prompt template that can be rendered with parameters.
@@ -36,7 +36,7 @@ A prompt template that can be rendered with parameters.
 
 **Methods:**
 
-#### `to_mcp_prompt`
+#### `to_mcp_prompt` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/prompts/prompt.py#L73"><Icon icon="github" size="14" /></a></sup>
 
 ```python
 to_mcp_prompt(self, **overrides: Any) -> MCPPrompt
@@ -45,7 +45,7 @@ to_mcp_prompt(self, **overrides: Any) -> MCPPrompt
 Convert the prompt to an MCP prompt.
 
 
-#### `from_function`
+#### `from_function` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/prompts/prompt.py#L91"><Icon icon="github" size="14" /></a></sup>
 
 ```python
 from_function(fn: Callable[..., PromptResult | Awaitable[PromptResult]], name: str | None = None, description: str | None = None, tags: set[str] | None = None, enabled: bool | None = None) -> FunctionPrompt
@@ -60,7 +60,7 @@ The function can return:
 - A sequence of any of the above
 
 
-### `FunctionPrompt`
+### `FunctionPrompt` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/prompts/prompt.py#L119"><Icon icon="github" size="14" /></a></sup>
 
 
 A prompt that is a function.
@@ -68,7 +68,7 @@ A prompt that is a function.
 
 **Methods:**
 
-#### `from_function`
+#### `from_function` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/prompts/prompt.py#L125"><Icon icon="github" size="14" /></a></sup>
 
 ```python
 from_function(cls, fn: Callable[..., PromptResult | Awaitable[PromptResult]], name: str | None = None, description: str | None = None, tags: set[str] | None = None, enabled: bool | None = None) -> FunctionPrompt

docs/python-sdk/fastmcp-prompts-prompt_manager.mdx

@@ -7,7 +7,7 @@ sidebarTitle: prompt_manager
 
 ## Classes
 
-### `PromptManager`
+### `PromptManager` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/prompts/prompt_manager.py#L21"><Icon icon="github" size="14" /></a></sup>
 
 
 Manages FastMCP prompts.
@@ -15,7 +15,7 @@ Manages FastMCP prompts.
 
 **Methods:**
 
-#### `mount`
+#### `mount` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/prompts/prompt_manager.py#L45"><Icon icon="github" size="14" /></a></sup>
 
 ```python
 mount(self, server: MountedServer) -> None
@@ -24,7 +24,7 @@ mount(self, server: MountedServer) -> None
 Adds a mounted server as a source for prompts.
 
 
-#### `add_prompt_from_fn`
+#### `add_prompt_from_fn` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/prompts/prompt_manager.py#L114"><Icon icon="github" size="14" /></a></sup>
 
 ```python
 add_prompt_from_fn(self, fn: Callable[..., PromptResult | Awaitable[PromptResult]], name: str | None = None, description: str | None = None, tags: set[str] | None = None) -> FunctionPrompt
@@ -33,7 +33,7 @@ add_prompt_from_fn(self, fn: Callable[..., PromptResult | Awaitable[PromptResult
 Create a prompt from a function.
 
 
-#### `add_prompt`
+#### `add_prompt` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/prompts/prompt_manager.py#L134"><Icon icon="github" size="14" /></a></sup>
 
 ```python
 add_prompt(self, prompt: Prompt) -> Prompt

docs/python-sdk/fastmcp-resources-resource.mdx

@@ -10,7 +10,7 @@ Base classes and interfaces for FastMCP resources.
 
 ## Classes
 
-### `Resource`
+### `Resource` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/resources/resource.py#L32"><Icon icon="github" size="14" /></a></sup>
 
 
 Base class for all resources.
@@ -18,13 +18,13 @@ Base class for all resources.
 
 **Methods:**
 
-#### `from_function`
+#### `from_function` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/resources/resource.py#L48"><Icon icon="github" size="14" /></a></sup>
 
 ```python
 from_function(fn: Callable[[], Any], uri: str | AnyUrl, name: str | None = None, description: str | None = None, mime_type: str | None = None, tags: set[str] | None = None, enabled: bool | None = None) -> FunctionResource
 ```
 
-#### `set_default_mime_type`
+#### `set_default_mime_type` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/resources/resource.py#L69"><Icon icon="github" size="14" /></a></sup>
 
 ```python
 set_default_mime_type(cls, mime_type: str | None) -> str
@@ -33,7 +33,7 @@ set_default_mime_type(cls, mime_type: str | None) -> str
 Set default MIME type if not provided.
 
 
-#### `set_default_name`
+#### `set_default_name` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/resources/resource.py#L76"><Icon icon="github" size="14" /></a></sup>
 
 ```python
 set_default_name(self) -> Self
@@ -42,7 +42,7 @@ set_default_name(self) -> Self
 Set default name from URI if not provided.
 
 
-#### `to_mcp_resource`
+#### `to_mcp_resource` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/resources/resource.py#L91"><Icon icon="github" size="14" /></a></sup>
 
 ```python
 to_mcp_resource(self, **overrides: Any) -> MCPResource
@@ -51,7 +51,7 @@ to_mcp_resource(self, **overrides: Any) -> MCPResource
 Convert the resource to an MCPResource.
 
 
-#### `key`
+#### `key` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/resources/resource.py#L105"><Icon icon="github" size="14" /></a></sup>
 
 ```python
 key(self) -> str
@@ -63,7 +63,7 @@ keys having a certain value, as the same tool loaded from different
 hierarchies of servers may have different keys.
 
 
-### `FunctionResource`
+### `FunctionResource` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/resources/resource.py#L115"><Icon icon="github" size="14" /></a></sup>
 
 
 A resource that defers data loading by wrapping a function.
@@ -80,7 +80,7 @@ The function can return:
 
 **Methods:**
 
-#### `from_function`
+#### `from_function` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/resources/resource.py#L131"><Icon icon="github" size="14" /></a></sup>
 
 ```python
 from_function(cls, fn: Callable[[], Any], uri: str | AnyUrl, name: str | None = None, description: str | None = None, mime_type: str | None = None, tags: set[str] | None = None, enabled: bool | None = None) -> FunctionResource

docs/python-sdk/fastmcp-resources-resource_manager.mdx

@@ -10,7 +10,7 @@ Resource manager functionality.
 
 ## Classes
 
-### `ResourceManager`
+### `ResourceManager` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/resources/resource_manager.py#L28"><Icon icon="github" size="14" /></a></sup>
 
 
 Manages FastMCP resources.
@@ -18,7 +18,7 @@ Manages FastMCP resources.
 
 **Methods:**
 
-#### `mount`
+#### `mount` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/resources/resource_manager.py#L60"><Icon icon="github" size="14" /></a></sup>
 
 ```python
 mount(self, server: MountedServer) -> None
@@ -27,7 +27,7 @@ mount(self, server: MountedServer) -> None
 Adds a mounted server as a source for resources and templates.
 
 
-#### `add_resource_or_template_from_fn`
+#### `add_resource_or_template_from_fn` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/resources/resource_manager.py#L182"><Icon icon="github" size="14" /></a></sup>
 
 ```python
 add_resource_or_template_from_fn(self, fn: Callable[..., Any], uri: str, name: str | None = None, description: str | None = None, mime_type: str | None = None, tags: set[str] | None = None) -> Resource | ResourceTemplate
@@ -48,7 +48,7 @@ Add a resource or template to the manager from a function.
 - returns the existing resource or template.
 
 
-#### `add_resource_from_fn`
+#### `add_resource_from_fn` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/resources/resource_manager.py#L230"><Icon icon="github" size="14" /></a></sup>
 
 ```python
 add_resource_from_fn(self, fn: Callable[..., Any], uri: str, name: str | None = None, description: str | None = None, mime_type: str | None = None, tags: set[str] | None = None) -> Resource
@@ -69,7 +69,7 @@ Add a resource to the manager from a function.
 - returns the existing resource.
 
 
-#### `add_resource`
+#### `add_resource` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/resources/resource_manager.py#L270"><Icon icon="github" size="14" /></a></sup>
 
 ```python
 add_resource(self, resource: Resource) -> Resource
@@ -83,7 +83,7 @@ will be used as the storage key. To overwrite it, call
 Resource.with_key() before calling this method.
 
 
-#### `add_template_from_fn`
+#### `add_template_from_fn` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/resources/resource_manager.py#L292"><Icon icon="github" size="14" /></a></sup>
 
 ```python
 add_template_from_fn(self, fn: Callable[..., Any], uri_template: str, name: str | None = None, description: str | None = None, mime_type: str | None = None, tags: set[str] | None = None) -> ResourceTemplate
@@ -92,7 +92,7 @@ add_template_from_fn(self, fn: Callable[..., Any], uri_template: str, name: str
 Create a template from a function.
 
 
-#### `add_template`
+#### `add_template` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/resources/resource_manager.py#L319"><Icon icon="github" size="14" /></a></sup>
 
 ```python
 add_template(self, template: ResourceTemplate) -> ResourceTemplate

docs/python-sdk/fastmcp-resources-template.mdx

@@ -10,13 +10,13 @@ Resource template functionality.
 
 ## Functions
 
-### `build_regex`
+### `build_regex` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/resources/template.py#L28"><Icon icon="github" size="14" /></a></sup>
 
 ```python
 build_regex(template: str) -> re.Pattern
 ```
 
-### `match_uri_template`
+### `match_uri_template` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/resources/template.py#L44"><Icon icon="github" size="14" /></a></sup>
 
 ```python
 match_uri_template(uri: str, uri_template: str) -> dict[str, str] | None
@@ -24,7 +24,7 @@ match_uri_template(uri: str, uri_template: str) -> dict[str, str] | None
 
 ## Classes
 
-### `ResourceTemplate`
+### `ResourceTemplate` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/resources/template.py#L52"><Icon icon="github" size="14" /></a></sup>
 
 
 A template for dynamically creating resources.
@@ -32,13 +32,13 @@ A template for dynamically creating resources.
 
 **Methods:**
 
-#### `from_function`
+#### `from_function` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/resources/template.py#L69"><Icon icon="github" size="14" /></a></sup>
 
 ```python
 from_function(fn: Callable[..., Any], uri_template: str, name: str | None = None, description: str | None = None, mime_type: str | None = None, tags: set[str] | None = None, enabled: bool | None = None) -> FunctionResourceTemplate
 ```
 
-#### `set_default_mime_type`
+#### `set_default_mime_type` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/resources/template.py#L90"><Icon icon="github" size="14" /></a></sup>
 
 ```python
 set_default_mime_type(cls, mime_type: str | None) -> str
@@ -47,7 +47,7 @@ set_default_mime_type(cls, mime_type: str | None) -> str
 Set default MIME type if not provided.
 
 
-#### `matches`
+#### `matches` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/resources/template.py#L96"><Icon icon="github" size="14" /></a></sup>
 
 ```python
 matches(self, uri: str) -> dict[str, Any] | None
@@ -56,7 +56,7 @@ matches(self, uri: str) -> dict[str, Any] | None
 Check if URI matches template and extract parameters.
 
 
-#### `to_mcp_template`
+#### `to_mcp_template` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/resources/template.py#L124"><Icon icon="github" size="14" /></a></sup>
 
 ```python
 to_mcp_template(self, **overrides: Any) -> MCPResourceTemplate
@@ -65,7 +65,7 @@ to_mcp_template(self, **overrides: Any) -> MCPResourceTemplate
 Convert the resource template to an MCPResourceTemplate.
 
 
-#### `from_mcp_template`
+#### `from_mcp_template` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/resources/template.py#L135"><Icon icon="github" size="14" /></a></sup>
 
 ```python
 from_mcp_template(cls, mcp_template: MCPResourceTemplate) -> ResourceTemplate
@@ -74,7 +74,7 @@ from_mcp_template(cls, mcp_template: MCPResourceTemplate) -> ResourceTemplate
 Creates a FastMCP ResourceTemplate from a raw MCP ResourceTemplate object.
 
 
-#### `key`
+#### `key` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/resources/template.py#L148"><Icon icon="github" size="14" /></a></sup>
 
 ```python
 key(self) -> str
@@ -86,7 +86,7 @@ keys having a certain value, as the same tool loaded from different
 hierarchies of servers may have different keys.
 
 
-### `FunctionResourceTemplate`
+### `FunctionResourceTemplate` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/resources/template.py#L158"><Icon icon="github" size="14" /></a></sup>
 
 
 A template for dynamically creating resources.
@@ -94,7 +94,7 @@ A template for dynamically creating resources.
 
 **Methods:**
 
-#### `from_function`
+#### `from_function` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/resources/template.py#L179"><Icon icon="github" size="14" /></a></sup>
 
 ```python
 from_function(cls, fn: Callable[..., Any], uri_template: str, name: str | None = None, description: str | None = None, mime_type: str | None = None, tags: set[str] | None = None, enabled: bool | None = None) -> FunctionResourceTemplate

docs/python-sdk/fastmcp-resources-types.mdx

@@ -10,19 +10,19 @@ Concrete resource implementations.
 
 ## Classes
 
-### `TextResource`
+### `TextResource` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/resources/types.py#L21"><Icon icon="github" size="14" /></a></sup>
 
 
 A resource that reads from a string.
 
 
-### `BinaryResource`
+### `BinaryResource` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/resources/types.py#L31"><Icon icon="github" size="14" /></a></sup>
 
 
 A resource that reads from bytes.
 
 
-### `FileResource`
+### `FileResource` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/resources/types.py#L41"><Icon icon="github" size="14" /></a></sup>
 
 
 A resource that reads from a file.
@@ -32,7 +32,7 @@ Set is_binary=True to read file as binary data instead of text.
 
 **Methods:**
 
-#### `validate_absolute_path`
+#### `validate_absolute_path` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/resources/types.py#L59"><Icon icon="github" size="14" /></a></sup>
 
 ```python
 validate_absolute_path(cls, path: Path) -> Path
@@ -41,7 +41,7 @@ validate_absolute_path(cls, path: Path) -> Path
 Ensure path is absolute.
 
 
-#### `set_binary_from_mime_type`
+#### `set_binary_from_mime_type` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/resources/types.py#L67"><Icon icon="github" size="14" /></a></sup>
 
 ```python
 set_binary_from_mime_type(cls, is_binary: bool, info: ValidationInfo) -> bool
@@ -50,13 +50,13 @@ set_binary_from_mime_type(cls, is_binary: bool, info: ValidationInfo) -> bool
 Set is_binary based on mime_type if not explicitly set.
 
 
-### `HttpResource`
+### `HttpResource` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/resources/types.py#L84"><Icon icon="github" size="14" /></a></sup>
 
 
 A resource that reads from an HTTP endpoint.
 
 
-### `DirectoryResource`
+### `DirectoryResource` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/resources/types.py#L100"><Icon icon="github" size="14" /></a></sup>
 
 
 A resource that lists files in a directory.
@@ -64,7 +64,7 @@ A resource that lists files in a directory.
 
 **Methods:**
 
-#### `validate_absolute_path`
+#### `validate_absolute_path` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/resources/types.py#L116"><Icon icon="github" size="14" /></a></sup>
 
 ```python
 validate_absolute_path(cls, path: Path) -> Path
@@ -73,7 +73,7 @@ validate_absolute_path(cls, path: Path) -> Path
 Ensure path is absolute.
 
 
-#### `list_files`
+#### `list_files` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/resources/types.py#L122"><Icon icon="github" size="14" /></a></sup>
 
 ```python
 list_files(self) -> list[Path]

docs/python-sdk/fastmcp-server-auth-auth.mdx

@@ -7,4 +7,4 @@ sidebarTitle: auth
 
 ## Classes
 
-### `OAuthProvider`
+### `OAuthProvider` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/auth/auth.py#L14"><Icon icon="github" size="14" /></a></sup>

docs/python-sdk/fastmcp-server-auth-providers-bearer.mdx

@@ -7,23 +7,23 @@ sidebarTitle: bearer
 
 ## Classes
 
-### `JWKData`
+### `JWKData` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/auth/providers/bearer.py#L29"><Icon icon="github" size="14" /></a></sup>
 
 
 JSON Web Key data structure.
 
 
-### `JWKSData`
+### `JWKSData` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/auth/providers/bearer.py#L42"><Icon icon="github" size="14" /></a></sup>
 
 
 JSON Web Key Set data structure.
 
 
-### `RSAKeyPair`
+### `RSAKeyPair` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/auth/providers/bearer.py#L49"><Icon icon="github" size="14" /></a></sup>
 
 **Methods:**
 
-#### `generate`
+#### `generate` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/auth/providers/bearer.py#L54"><Icon icon="github" size="14" /></a></sup>
 
 ```python
 generate(cls) -> 'RSAKeyPair'
@@ -35,7 +35,7 @@ Generate an RSA key pair for testing.
 - (private_key_pem, public_key_pem)
 
 
-#### `create_token`
+#### `create_token` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/auth/providers/bearer.py#L88"><Icon icon="github" size="14" /></a></sup>
 
 ```python
 create_token(self, subject: str = 'fastmcp-user', issuer: str = 'https://fastmcp.example.com', audience: str | list[str] | None = None, scopes: list[str] | None = None, expires_in_seconds: int = 3600, additional_claims: dict[str, Any] | None = None, kid: str | None = None) -> str
@@ -57,7 +57,7 @@ Generate a test JWT token for testing purposes.
 - Signed JWT token string
 
 
-### `BearerAuthProvider`
+### `BearerAuthProvider` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/auth/providers/bearer.py#L149"><Icon icon="github" size="14" /></a></sup>
 
 
 Simple JWT Bearer Token validator for hosted MCP servers.

docs/python-sdk/fastmcp-server-auth-providers-bearer_env.mdx

@@ -7,13 +7,13 @@ sidebarTitle: bearer_env
 
 ## Classes
 
-### `EnvBearerAuthProviderSettings`
+### `EnvBearerAuthProviderSettings` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/auth/providers/bearer_env.py#L8"><Icon icon="github" size="14" /></a></sup>
 
 
 Settings for the BearerAuthProvider.
 
 
-### `EnvBearerAuthProvider`
+### `EnvBearerAuthProvider` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/auth/providers/bearer_env.py#L24"><Icon icon="github" size="14" /></a></sup>
 
 
 A BearerAuthProvider that loads settings from environment variables. Any

docs/python-sdk/fastmcp-server-auth-providers-in_memory.mdx

@@ -7,7 +7,7 @@ sidebarTitle: in_memory
 
 ## Classes
 
-### `InMemoryOAuthProvider`
+### `InMemoryOAuthProvider` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/auth/providers/in_memory.py#L31"><Icon icon="github" size="14" /></a></sup>
 
 
 An in-memory OAuth provider for testing purposes.

docs/python-sdk/fastmcp-server-context.mdx

@@ -7,7 +7,7 @@ sidebarTitle: context
 
 ## Functions
 
-### `set_context`
+### `set_context` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/context.py#L36"><Icon icon="github" size="14" /></a></sup>
 
 ```python
 set_context(context: Context) -> Generator[Context, None, None]
@@ -15,7 +15,7 @@ set_context(context: Context) -> Generator[Context, None, None]
 
 ## Classes
 
-### `Context`
+### `Context` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/context.py#L45"><Icon icon="github" size="14" /></a></sup>
 
 
 Context object providing access to MCP capabilities.
@@ -53,7 +53,7 @@ The context is optional - tools that don't need it can omit the parameter.
 
 **Methods:**
 
-#### `request_context`
+#### `request_context` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/context.py#L98"><Icon icon="github" size="14" /></a></sup>
 
 ```python
 request_context(self) -> RequestContext
@@ -64,7 +64,7 @@ Access to the underlying request context.
 If called outside of a request context, this will raise a ValueError.
 
 
-#### `client_id`
+#### `client_id` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/context.py#L168"><Icon icon="github" size="14" /></a></sup>
 
 ```python
 client_id(self) -> str | None
@@ -73,7 +73,7 @@ client_id(self) -> str | None
 Get the client ID if available.
 
 
-#### `request_id`
+#### `request_id` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/context.py#L177"><Icon icon="github" size="14" /></a></sup>
 
 ```python
 request_id(self) -> str
@@ -82,7 +82,7 @@ request_id(self) -> str
 Get the unique ID for this request.
 
 
-#### `session_id`
+#### `session_id` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/context.py#L182"><Icon icon="github" size="14" /></a></sup>
 
 ```python
 session_id(self) -> str | None
@@ -99,7 +99,7 @@ the same client session.
 - for stdio and in-memory transports which don't use session IDs.
 
 
-#### `session`
+#### `session` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/context.py#L213"><Icon icon="github" size="14" /></a></sup>
 
 ```python
 session(self)
@@ -108,7 +108,7 @@ session(self)
 Access to the underlying session for advanced usage.
 
 
-#### `get_http_request`
+#### `get_http_request` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/context.py#L282"><Icon icon="github" size="14" /></a></sup>
 
 ```python
 get_http_request(self) -> Request

docs/python-sdk/fastmcp-server-dependencies.mdx

@@ -7,19 +7,19 @@ sidebarTitle: dependencies
 
 ## Functions
 
-### `get_context`
+### `get_context` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/dependencies.py#L27"><Icon icon="github" size="14" /></a></sup>
 
 ```python
 get_context() -> Context
 ```
 
-### `get_http_request`
+### `get_http_request` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/dependencies.py#L39"><Icon icon="github" size="14" /></a></sup>
 
 ```python
 get_http_request() -> Request
 ```
 
-### `get_http_headers`
+### `get_http_headers` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/dependencies.py#L48"><Icon icon="github" size="14" /></a></sup>
 
 ```python
 get_http_headers(include_all: bool = False) -> dict[str, str]

docs/python-sdk/fastmcp-server-http.mdx

@@ -7,13 +7,13 @@ sidebarTitle: http
 
 ## Functions
 
-### `set_http_request`
+### `set_http_request` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/http.py#L48"><Icon icon="github" size="14" /></a></sup>
 
 ```python
 set_http_request(request: Request) -> Generator[Request, None, None]
 ```
 
-### `setup_auth_middleware_and_routes`
+### `setup_auth_middleware_and_routes` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/http.py#L72"><Icon icon="github" size="14" /></a></sup>
 
 ```python
 setup_auth_middleware_and_routes(auth: OAuthProvider) -> tuple[list[Middleware], list[BaseRoute], list[str]]
@@ -29,7 +29,7 @@ Set up authentication middleware and routes if auth is enabled.
 - Tuple of (middleware, auth_routes, required_scopes)
 
 
-### `create_base_app`
+### `create_base_app` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/http.py#L110"><Icon icon="github" size="14" /></a></sup>
 
 ```python
 create_base_app(routes: list[BaseRoute], middleware: list[Middleware], debug: bool = False, lifespan: Callable | None = None) -> StarletteWithLifespan
@@ -48,7 +48,7 @@ Create a base Starlette app with common middleware and routes.
 - A Starlette application
 
 
-### `create_sse_app`
+### `create_sse_app` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/http.py#L138"><Icon icon="github" size="14" /></a></sup>
 
 ```python
 create_sse_app(server: FastMCP[LifespanResultT], message_path: str, sse_path: str, auth: OAuthProvider | None = None, debug: bool = False, routes: list[BaseRoute] | None = None, middleware: list[Middleware] | None = None) -> StarletteWithLifespan
@@ -70,7 +70,7 @@ Returns:
     A Starlette application with RequestContextMiddleware
 
 
-### `create_streamable_http_app`
+### `create_streamable_http_app` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/http.py#L246"><Icon icon="github" size="14" /></a></sup>
 
 ```python
 create_streamable_http_app(server: FastMCP[LifespanResultT], streamable_http_path: str, event_store: EventStore | None = None, auth: OAuthProvider | None = None, json_response: bool = False, stateless_http: bool = False, debug: bool = False, routes: list[BaseRoute] | None = None, middleware: list[Middleware] | None = None) -> StarletteWithLifespan
@@ -96,17 +96,17 @@ Return an instance of the StreamableHTTP server app.
 
 ## Classes
 
-### `StarletteWithLifespan`
+### `StarletteWithLifespan` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/http.py#L41"><Icon icon="github" size="14" /></a></sup>
 
 **Methods:**
 
-#### `lifespan`
+#### `lifespan` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/http.py#L43"><Icon icon="github" size="14" /></a></sup>
 
 ```python
 lifespan(self) -> Lifespan
 ```
 
-### `RequestContextMiddleware`
+### `RequestContextMiddleware` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/http.py#L56"><Icon icon="github" size="14" /></a></sup>
 
 
 Middleware that stores each request in a ContextVar

docs/python-sdk/fastmcp-server-middleware-__init__.mdx

@@ -0,0 +1,8 @@
+---
+title: __init__
+sidebarTitle: __init__
+---
+
+# `fastmcp.server.middleware`
+
+*This module is empty or contains only private/internal implementations.*