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

# Start building with Skybridge

> Everything you need to build MCP Apps that run in ChatGPT and Claude

Skybridge is a fullstack TypeScript framework for building MCP Apps: interactive [views](https://docs.skybridge.tech/build/view.md) that render inside model hosts. Define [tools](https://docs.skybridge.tech/build/tools.md), write React components, and let Skybridge do the rest:

```ts server.ts theme={null}
import { Skybridge } from "skybridge/server";
import { z } from "zod";

export const app = new Skybridge({
  name: "my-app",
  version: "0.0.1",
  handler: (server) =>
    server.registerTool(
      {
        name: "greeting",
        description: "Greet someone by name.",
        inputSchema: { name: z.string() },
        view: { component: "greeting" },
      },
      async ({ name }) => {
        return { structuredContent: { message: `Hello, ${name}!` } };
      },
    ),
});
```

```tsx views/greeting.tsx theme={null}
import { useToolInfo } from "../helpers.js"; // generated, type-safe from server schema

export default function Greeting() {
  const { output } = useToolInfo<"greeting">();
  return <h1>{output.message}</h1>;
}
```

Start building now by [scaffolding your first project](https://docs.skybridge.tech/get-started/quickstart.md#scaffold-your-project):

```bash theme={null}
npx skybridge create
```

## MCP Apps Are Hard, but Not for You

MCP Apps are the surface on which humans and agents use software collaboratively. In practice, those apps use the [Model Context Protocol](https://modelcontextprotocol.io/) to run inside model hosts such as ChatGPT and Claude.

MCP Apps introduce a fundamental shift: unlike bidirectional web apps, they are three-way systems where data flows between your app, the user, and the model. It boils down to mastering these core concepts:

> [card] [Architecture](https://docs.skybridge.tech/get-started/architecture.md)
>
> Design experiences leveraging model intelligence.

> [card] [Tools](https://docs.skybridge.tech/build/tools.md)
>
> Define what humans and agents can see and do.

> [card] [Views](https://docs.skybridge.tech/build/view.md)
>
> Craft interactive UIs rendered in conversation.

Skybridge is built around all three; it's the fastest, most complete way to build full-fledged MCP Apps. Protocol, [authentication](https://docs.skybridge.tech/build/auth.md), and [host support](http://localhost:3000/api-reference/overview) are baked in. It comes with a dead-simple architecture and a complete tooling suite, including HMR, [emulator](https://docs.skybridge.tech/test/devtools.md), [tunneling](https://docs.skybridge.tech/test/tunnel.md), [playground](https://docs.skybridge.tech/test/playground.md), and [deployment](https://docs.skybridge.tech/ship). Your sole focus: what makes your app great.

## The AI Sidekick of Your AI Sidekick

With the Skybridge Skill, coding agents can autonomously develop MCP Apps. Better still, Skybridge-pilled LLMs help you brainstorm ideas, design [UX](https://docs.skybridge.tech/guides/ux.md), and craft great apps that actually [make sense](https://docs.skybridge.tech/get-started/architecture.md) inside ChatGPT or Claude.

Install it now:

```bash theme={null}
npx skills add alpic-ai/skybridge -s skybridge
```

> [card] [Quickstart](https://docs.skybridge.tech/get-started/quickstart.md)
>
> Build, test, and deploy your first MCP App

> [card] [Architecture](https://docs.skybridge.tech/get-started/architecture.md)
>
> Design conversational experiences leveraging model intelligence

> [card] [Build](https://docs.skybridge.tech/build)
>
> Learn everything that makes great MCP Apps


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