> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mcp-use.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Welcome

> Full-stack MCP framework for **TypeScript**

For the complete documentation index, see
[llms.txt](https://mcp-use.com/docs/llms.txt).

**mcp-use** is the fullstack MCP framework for TypeScript. Build MCP Servers, MCP Apps (interactive widgets that run inside ChatGPT and Claude), MCP Agents, and MCP Clients with end-to-end type safety.

```typescript server.ts theme={null}
import { MCPServer } from "mcp-use";
import { z } from "zod";

const server = new MCPServer({
name: "greeter",
version: "1.0.0",
});

export const greet = server.tool(
  {
    name: "greet",
    description: "Greet someone by name",
    inputSchema: z.object({ name: z.string().describe("Who to greet") }),
    outputSchema: z.object({ greeting: z.string() }),
    view: { name: "greeting" },
  },
  async ({ name }) => ({
    content: [{ type: "text", text: `Said hello to ${name}` }],
    structuredContent: { greeting: `Hello, ${name}!` },
  }),
);

await server.listen(3000);

```

```tsx views/greeting/view.tsx theme={null}
import { useToolContext } from "mcp-use/react";

export default function Greeting() {
  const view = useToolContext<"greet">();
  if (view.status === "pending") return <p>Loading…</p>;
  if (view.status === "error") return <p>{view.error.message}</p>;
  return <h1>👋 {view.toolOutput.greeting}</h1>;
}
```

Looking for the **Python** docs? They're
[here](https://docs.mcp-use.com/python/getting-started/quickstart.md).

> [card] [New to MCP?](https://docs.mcp-use.com/home/mcp101)
>
> Start with MCP 101 - principles of the protocol, its three primitives, and how
> clients, servers, and agents fit together.

## Next Steps

> [card] [Quickstart](https://docs.mcp-use.com/v1/typescript/getting-started/quickstart.md)
>
> Build your first MCP server in under 5 minutes.

> [card] [Installation](https://docs.mcp-use.com/v1/typescript/getting-started/installation.md)
>
> Set up your Node project.

> [card] [MCP Server](https://docs.mcp-use.com/v1/typescript/server.md)
>
> Expose tools, resources, and prompts to any AI agent.

> [card] [MCP Apps](https://docs.mcp-use.com/v1/typescript/mcp-apps.md)
>
> Build interactive widgets for Claude and ChatGPT.

> [card] [MCP Client](https://docs.mcp-use.com/v1/typescript/client/index.md)
>
> Connect to any MCP server programmatically.

> [card] [MCP Agent](https://docs.mcp-use.com/v1/typescript/agent/index.md)
>
> AI agents with tool-calling capabilities.

> [!TIP]
>
> **Need help?** Join our [Discord](https://discord.gg/XkNkSkMz3V) or check out
> [GitHub](https://github.com/mcp-use/mcp-use).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.