* 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
* docs: add llms.txt directive blockquote to landing pages
Adds a blockquote pointing to /llms.txt at the top of the main landing
pages so agents have a clear, page-level pointer to the documentation
index. Addresses the LLMS TXT Directive check in agent-readiness audits.
* docs: hide llms.txt directive from human readers via display:none
The directive is for agents (which still see it in DOM/markdown export),
not humans, so wrap each blockquote in a hidden div to remove visual
noise from landing pages.
* docs: use absolute URL for llms.txt directive
Mintlify's broken-link checker validates relative paths against pages
in docs.json, and /llms.txt is an auto-generated artifact at host root,
not a navigation page. Switch to the absolute URL so CI passes; agents
still see a same-host link.
* docs: point llms.txt directive at canonical manufact.com URL
Skips the 2 cross-host 301 hops from docs.mcp-use.com so agents reach
the index in one request.
* docs: remove redirect-audit.md from PR
This was an internal diagnostic file accidentally bundled into the
llms.txt directive PR. Keeping it locally for reference, not for
shipping in docs.
* Add uvx create-mcp-use command
* Update docs
* Add docs
* feat(python/cli): improve create-mcp-use with rich UI, dependency install, and telemetry
- Use rich for colored output, spinner, and panel for get-started instructions
- Add ASCII logo matching the TypeScript CLI
- Prompt user to install dependencies after scaffolding (detects uv/pip)
- Add --install and --no-install flags for non-interactive use
- Capture install output to keep terminal clean
- Add CreateMCPUseEvent telemetry to track CLI usage
- Fix starter template pyproject.toml hatch build config for installability
* feat(python/server): auto-retry next available port when default is in use
Add port availability checking before starting uvicorn. When the
requested port is occupied, the server automatically tries the next
port (up to 10 retries) instead of crashing.
Refs #1161
* fix(python/cli): fix linting errors in create-mcp-use CLI
* Revert "feat(python/server): auto-retry next available port when default is in use"
This reverts commit baf3d3233e.
* fix(python/cli): address PR review feedback
- Fix ruff format issues in cli.py
- Fix "Cli" → "CLI" in docs title
- Fix "a MCP" → "an MCP" grammar in quickstart
* docs(python): regenerate API docs for CLI module
* docs: update
---------
Co-authored-by: pietrozullo <pietro.zullo@gmail.com>
- Add welcome page with py_welcome.png image
- Rewrite quickstart with Agent/Client/Server sections and mermaid diagram
- Simplify installation page (single package, no separate sections)
- Add updates symlink to changelog in getting-started
- Remove configuration overview page, update broken links to specific pages
- Update changelog title to "Updates"
* 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