docs: add LLM adapters to documentation navigation

- Add link in docs/index.md Getting Started section
- Add entry in mkdocs.yml navigation
- Add reference in README.md Advanced Usage section
- Register example script in pyproject.toml

Author: dgenio

README.md

@@ -2487,6 +2487,40 @@ if __name__ == "__main__":
     asyncio.run(main())
 ```
 
+### Converting MCP Tools for LLM Providers
+
+When integrating MCP tools with LLM providers (like Gemini, GPT-4, or Claude), you need to convert MCP tool schemas to the provider's format. The SDK makes this easy with comprehensive documentation and examples.
+
+See the [LLM Provider Adapters guide](https://modelcontextprotocol.github.io/python-sdk/llm-adapters/) for:
+
+- Complete adapter implementations for Gemini, OpenAI, and Anthropic Claude
+- Best practices for schema conversion
+- Error handling patterns
+- Advanced conversion techniques
+
+<!-- snippet-source examples/snippets/clients/llm_adapter_example.py -->
+```python
+"""Example: Convert MCP tools to various LLM provider formats."""
+
+from mcp import ClientSession, StdioServerParameters, types
+from mcp.client.stdio import stdio_client
+
+# After connecting to an MCP server and listing tools:
+tools_response = await session.list_tools()
+
+# Convert to Gemini format
+gemini_tools = [to_gemini_function_declaration(tool) for tool in tools_response.tools]
+
+# Convert to OpenAI format
+openai_tools = [to_openai_function(tool) for tool in tools_response.tools]
+
+# Convert to Claude format
+claude_tools = [to_claude_tool(tool) for tool in tools_response.tools]
+```
+
+_Full example: [examples/snippets/clients/llm_adapter_example.py](https://github.com/modelcontextprotocol/python-sdk/blob/main/examples/snippets/clients/llm_adapter_example.py)_
+<!-- /snippet-source -->
+
 ### MCP Primitives
 
 The MCP protocol defines three core primitives that servers can implement:
@@ -2512,6 +2546,7 @@ MCP servers declare capabilities during initialization:
 ## Documentation
 
 - [API Reference](https://modelcontextprotocol.github.io/python-sdk/api/)
+- [LLM Provider Adapters](https://modelcontextprotocol.github.io/python-sdk/llm-adapters/) - Convert MCP tools to LLM provider formats
 - [Model Context Protocol documentation](https://modelcontextprotocol.io)
 - [Model Context Protocol specification](https://modelcontextprotocol.io/specification/latest)
 - [Officially supported servers](https://github.com/modelcontextprotocol/servers)

docs/index.md

@@ -61,6 +61,7 @@ npx -y @modelcontextprotocol/inspector
 2. **[Learn concepts](concepts.md)** - understand the three primitives and architecture
 3. **[Explore authorization](authorization.md)** - add security to your servers
 4. **[Use low-level APIs](low-level-server.md)** - for advanced customization
+5. **[Create LLM adapters](llm-adapters.md)** - convert MCP tools to LLM provider formats
 
 ## API Reference
 

examples/snippets/pyproject.toml

@@ -22,3 +22,4 @@ direct-execution-server = "servers.direct_execution:main"
 display-utilities-client = "clients.display_utilities:main"
 oauth-client = "clients.oauth_client:run"
 elicitation-client = "clients.url_elicitation_client:run"
+llm-adapter-example = "clients.llm_adapter_example:run"

mkdocs.yml

@@ -17,6 +17,7 @@ nav:
       - Concepts: concepts.md
       - Low-Level Server: low-level-server.md
       - Authorization: authorization.md
+      - LLM Provider Adapters: llm-adapters.md
       - Testing: testing.md
   - API Reference: api.md