Files
mcp-use__mcp-use/docs/python/getting-started/welcome.mdx
Pietro Zullo 8348c59a53 docs: reorganize, fix accuracy, and update for agent readability (#1502)
* 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
2026-05-14 18:49:06 +02:00

49 lines
2.6 KiB
Plaintext

---
title: "Welcome"
description: "Full-stack MCP framework for **Python**"
icon: "heart-handshake"
---
<Visibility for="agents">
For the complete documentation index, see [llms.txt](https://mcp-use.com/docs/llms.txt).
</Visibility>
**mcp-use** is the fullstack MCP framework for Python. Build MCP Servers, MCP Apps, MCP Agents, and MCP Clients with a clean, typed, async-native API.
![mcp-use](/images/py_welcome.png)
<Callout color='#3178c6' icon={<svg xmlns="http://www.w3.org/2000/svg" className='min-w-[20px] mt-0 flex-shrink-0' viewBox="0 0 128 128"><path fill="#007acc" d="M2 63.91v62.5h125v-125H2zm100.73-5a15.56 15.56 0 017.82 4.5 20.58 20.58 0 013 4c0 .16-5.4 3.81-8.69 5.85-.12.08-.6-.44-1.13-1.23a7.09 7.09 0 00-5.87-3.53c-3.79-.26-6.23 1.73-6.21 5a4.58 4.58 0 00.54 2.34c.83 1.73 2.38 2.76 7.24 4.86 8.95 3.85 12.78 6.39 15.16 10 2.66 4 3.25 10.46 1.45 15.24-2 5.2-6.9 8.73-13.83 9.9a38.32 38.32 0 01-9.52-.1A23.82 23.82 0 0180.4 109a24.48 24.48 0 01-3.36-4.86c-.15-.34.39-.72 5.37-3.84l4.34-2.59.8 1.12a13.41 13.41 0 004.32 4.48 10.35 10.35 0 0011.3-.68 5.29 5.29 0 001.5-5.17c-.68-2-2.35-3.18-7.55-5.32A38.34 38.34 0 0186.57 87a20.3 20.3 0 01-4.43-5.78 22.32 22.32 0 01-1.8-8.24 20.51 20.51 0 012.56-10.43c2.32-3.8 6.39-6.63 11.63-8.1a31.4 31.4 0 0112.2.27zM73.39 67.41v5h-17.8v49.5h-11v-49.5H26.77v-4.85c0-2.69.06-5 .12-5.1s8.45-.1 18.64-.06l18.39.08z"/></svg>}>
Looking for the **TypeScript** docs? They're [here](/typescript/getting-started/welcome).
</Callout>
<Card title="New to MCP?" icon="brain" href="/home/mcp101">
Start with MCP 101 - principles of the protocol, its three primitives, and how clients, servers, and agents fit together.
</Card>
## Next Steps
<CardGroup cols={2}>
<Card title="Quickstart" icon="rocket" href="/python/getting-started/quickstart">
Build your first MCP server in under 5 minutes.
</Card>
<Card title="Installation" icon="download" href="/python/getting-started/installation">
Set up your Python environment.
</Card>
<Card title="MCP Server" icon="server" href="/python/server/index">
Expose tools, resources, and prompts to any AI agent.
</Card>
<Card title="MCP Client" icon="router" href="/python/client/client-configuration">
Connect to any MCP server programmatically.
</Card>
<Card title="MCP Agent" icon="brain" href="/python/agent/agent-configuration">
AI agents with tool-calling capabilities.
</Card>
<Card title="Inspector" icon="bug-play" href="/inspector/index">
Debug and test MCP servers interactively.
</Card>
</CardGroup>
<Tip>
**Need help?** Join our [Discord](https://discord.gg/XkNkSkMz3V) or check out [GitHub](https://github.com/mcp-use/mcp-use).
</Tip>