* docs: reorganize navigation and clean up content
- Remove 'Misc' group with misplaced blog posts
- Remove 'Libraries' redirect group from Home nav
- Simplify 'Dev Tools' group (flatten Inspector, CLI, Tunneling)
- Remove individual changelog versions from Python nav (keep summary)
- Remove changelog from TypeScript 'Get Started' group
- Remove tunneling duplicate from Python Development group
- Rewrite mcp101 as clean MCP concepts page (was pitch deck)
- Delete typescript/blog posts (not technical docs)
- Add redirects for deleted blog post URLs
* docs: fix content accuracy and remove sloppy language
- Fix broken python/server/mcp-apps link in home page
- Remove informal pitch-speak from python/server/index.mdx
- Fix grammar error in typescript/server/index.mdx
- Update typescript/client/logging.mdx: remove fake 'coming soon' API code
- Fix non-existent model name gpt-5.1 in typescript quickstart
- Fix mcp_use naming in development contributing guide
* docs: fix incorrect TypeScript server API calls in inspector docs
- Replace server.addTool() with server.tool() (correct mcp-use API)
- Add missing zod import to debugging-chatgpt-apps example
* docs: fix fake model names (gpt-5.1 → gpt-4o) in agent docs
* docs: update model names, fix APIs, and add agent visibility hints
- Replace all deprecated model names with latest: gpt-4.1, gpt-4.1-mini,
claude-sonnet-4-6, claude-opus-4-7, gemini-2.5-flash across all docs
- Fix TypeScript server.tool() API in installation.mdx (old positional string form)
- Fix TypeScript agent.run() in quickstart.mdx (deprecated string form → object)
- Remove broken manufact.com/docs/llms.txt hidden hints from 5 pages
- Add <Visibility for="agents"> block to mcp101.mdx with install commands,
key classes, and API signatures for agent-oriented navigation
- Add LangChain provider install note to Python quickstart (mcp-use agent
requires a separate langchain-* provider package)
- Update model name cards in Python llm-integration.mdx
* docs: clean up remaining stale model names and improve accuracy
- Update supported model lists in Python and TypeScript llm-integration pages
- Fix cost optimization table to use current model IDs
- Update TypeScript agent overview supported providers list
* docs: add LangChain provider install to TypeScript quickstart agent section
The MCPAgent requires a separate @langchain/* provider package; this was
not mentioned before the code example that imports from @langchain/openai.
* docs: update to latest flagship model IDs (May 2026)
- OpenAI: gpt-4.1 → gpt-5.5, gpt-4.1-mini → gpt-5.5-mini
- Google: gemini-2.5-flash → gemini-3.1-flash, gemini-2.5-pro → gemini-3.1-pro
- Groq: llama-3.1-* → llama-4-scout-17b-16e-instruct
- Anthropic (claude-opus-4-7, claude-sonnet-4-6) already current, no change
* docs: replace all em dashes with hyphens
* docs: restore llms.txt hints using Visibility component
* docs: simplify TypeScript logging page to unsupported notice only
* docs: rewrite mcp101 to explain MCP protocol with mcp-use examples and doc links
* docs: remove goal.md
* docs: revert nav changes, keep only Misc group removal and blog redirects
* docs: reorder mcp101 to Server/App -> Client/Inspector -> Agent, restore title
* docs: add code examples for Resources and Prompts in mcp101
* docs: remove em dashes from mcp101
* docs: add MCPClient code examples to mcp101
* docs: add React client example to mcp101
* docs: add agent code examples to mcp101
* docs: expand MCP Apps section in mcp101 with example and links
* docs: restore Contacts, Socials, and Founders sections to mcp101
* docs: add context-setting intro paragraph to mcp101 for new readers
* docs: add MCP stores section to mcp101 intro with Claude, ChatGPT, Cursor
* docs: fix Claude store link
* docs: fix ChatGPT store link
* docs: fix Cursor store link
* docs: replace store Cards with linked image grid
* docs: add captions to store images
* docs: add Notifications to client primitives table in mcp101
* docs: add lead-in paragraph before resource cards at bottom of mcp101
* docs: move resource cards to end of page after Contacts/Socials/Founders
* docs: demote Contacts/Socials/Founders to bold text to remove from TOC
* docs: move Contacts/Socials/Founders to very end of mcp101
* docs: add Resources and Contacts section headers, link official MCP docs
* chore(docs): update site metadata, footer links, and rename mcp_use to mcp-use
* update docs metadata + images
* docs: enhance MCP section by highlighting the reach of MCP stores with 1 billion weekly active users
* api ref
* fix(python/server): simplify tool JSON Schema for Optional parameters
Pydantic generates {"anyOf": [{"type": "T"}, {"type": "null"}]} for
Optional[T] tool parameters. While valid JSON Schema 2020-12, this
pattern breaks description rendering in the MCP Inspector UI and fails
Gemini API validation (requires top-level type field). MCP signals
optionality via the required array, making the anyOf/null wrapper
redundant.
- Add simplify_optional_schema() utility that collapses nullable anyOf
into flat {"type": "T"} while preserving description, default, title
- Override MCPServer.add_tool() to apply simplification after Pydantic
generates the schema
- Add 12 unit tests for the schema simplifier (test_json_schema.py)
- Add 23 unit tests for tool schema output (test_list_tool_format.py)
- Update server_example.py with representative parameter patterns
including Literal enum types
* docs(python/server): add parameter types and JSON Schema section to tools docs
Document the Python-to-JSON-Schema type mapping, required/optional/nullable
parameter patterns, and Literal enum usage. Includes a note explaining the
anyOf/null simplification that mcp-use applies automatically.
* fix(python/server): address PR review comments on json_schema.py
- Fix _simplify_property docstring: says "in place" but returns new dict
- Fix simplify_optional_schema docstring: document fast-path return when
no properties exist (returns original, not a copy)
- Wrap dict comprehension for line length
* style: format server_example.py
* docs: regenerate API reference for json_schema module
- Added detailed examples for defining tools, prompts, and resources in Python, showcasing their usage with annotations and context.
- Updated README to include a Python server example for weather information retrieval.
- Improved clarity on prompt and resource definitions, including argument descriptions and JSON-RPC responses.
- Enhanced documentation for better understanding of dynamic resources and tool functionalities.
* fix(python/server): improve debug and pretty_print_jsonrpc behavior
- Make pretty_print_jsonrpc work independently of debug_level
(previously required DEBUG=2 environment variable)
- Rename run_debug to debug in server.run() for consistency
- Make run(debug=True) override server's debug_level if it was 0
- Remove aggressive signal handlers that broke thread compatibility
(uvicorn handles SIGINT/SIGTERM gracefully)
- Update all documentation to use new debug parameter name
* refactor(python/server): remove unused lupo_tool function from server_example.py
* docs: update signals API reference after simplification
* refactor: remove unused signals.py module
uvicorn already handles SIGINT/SIGTERM gracefully, so custom signal
handlers are unnecessary. Removed the signals.py file and all references
to setup_signal_handlers().
* chore: remove analysis files
* feat: server first implementation
* docs: docs for server and images
* chore: locked langchain dependencies in pyproject.toml (#321)
* python/release/1.3.13
* catch uvicorn logs && log session id
* fix debug logic
* docs: logging update
* fix: icon of elicitation
* fix installation paths for local clones
* docs: minor restructuring
* docs: reorganization, killed non existing pages
* docs: beta tag on server
* chore: example servers
* feat: inspector autopopulated and client only
* feat: enhance MCP logging system with customizable formats and improved middleware
* feat: implement weather alert and forecast tools in FastMCP example server
* mcp path configurable
* fix inspector
* export as FastMCP too
* chore: update fastmcp migration example
* lock inspector version
* type runner
* unhide docs and remove dangers
* migration diff
* docs and context example
* export context
* logging improvement
* pretty JSON RPC
* autoConnect url param in inspecotr
* move logging
* type check
* Server Router
* show response logs
* fallback tool name to function name in router registration
* compatibility export
* Introduced ty and prek as type checker and precommit engine respectively - moved ruff config in pyproject toml
* add ty check
* ty runs only on staged files
* ty configuration fix
* move startup info in logging
* remove bug from action
* update claude rules
* fix resource serialization
* comments on inspector errors
* abstracted runner transports
* remove redunant call for network
* fix ip getter
* add inspector mcp path
* response limit logging
* disable ty check in action
* moved transport type to types
* support sse
* show transport type in logs
* change default transport
* refactored tests to use mcp server
* removed fastmcp
* file restructuring
* test table
* sampling, elicitation, tool disabling enabling
* deprecte sse server side
* simplified report
* fix action
* remove sse deprecated test
* move tests files to allow for server integration tests
* docs
* reorg integration test files
* api-reference-doxs
* fix broken links
* telemetry
* remove feature useage from scarf
* Check out feat/server/python branch with latest docs
* feat: structure v1
* feat: product navigation
* stubs
* emtpy pages
* feat: home page
* autogenerate docs updated
* side bar on home page with redirects
* theme adaptation of welcome cards
* cleanup logos
* cleanup
* WIP disclosure in Python Server
* feat: add initial documentation and images for MCP server framework
* feat: add TypeScript documentation for mcp agent and mcp client + remove typescript reference from python files
* fix: update sandbox documentation for Python and TypeScript clients
- Adjusted Python sandbox documentation for clarity in API key usage.
- Added a warning in TypeScript documentation indicating that sandbox execution is not yet supported, with a reference to the Python version for users needing this functionality.
* feat: enhance TypeScript SDK documentation with new icons and structured navigation
* fix
* feat: update getting started guide
* refactor: remove sandboxed execution section from TypeScript connection types documentation
- Deleted the Sandboxed Execution section, including installation instructions and characteristics.
- Updated the Choosing the Right Connection Type section to reflect the removal of sandboxed execution details.
* feat: add observability documentation for MCP agents
* feat: add comprehensive documentation for MCP server framework
* feat: expand TypeScript server documentation with new templates, prompts, and UI widgets sections
* fix
* color hover
* remove inspector
* feat: remove claude code review
* fix: broken links
---------
Co-authored-by: Luigi Pederzani <luigipederzani@gmail.com>
Pietro Zullo