# Skybridge

> The #1 full stack open-source TS framework for building ChatGPT and MCP Apps

## Docs

- [auth0Provider](https://skybridge-staging-qchuchu-ext-apps-host-styles.mintlify.site/api-reference/auth0-provider.md): Wire OAuth from an Auth0 tenant
- [clerkProvider](https://skybridge-staging-qchuchu-ext-apps-host-styles.mintlify.site/api-reference/clerk-provider.md): Wire OAuth from a Clerk instance
- [CLI](https://skybridge-staging-qchuchu-ext-apps-host-styles.mintlify.site/api-reference/cli.md): Test, build, and run your app from the terminal
- [createStore](https://skybridge-staging-qchuchu-ext-apps-host-styles.mintlify.site/api-reference/create-store.md): Persist view state in a Zustand store
- [customProvider](https://skybridge-staging-qchuchu-ext-apps-host-styles.mintlify.site/api-reference/custom-provider.md): Wire OAuth from any IdP's discovery document
- [data-llm](https://skybridge-staging-qchuchu-ext-apps-host-styles.mintlify.site/api-reference/data-llm.md): Narrate the view's state to the model
- [descopeProvider](https://skybridge-staging-qchuchu-ext-apps-host-styles.mintlify.site/api-reference/descope-provider.md): Wire OAuth from a Descope MCP Server
- [FileRef](https://skybridge-staging-qchuchu-ext-apps-host-styles.mintlify.site/api-reference/file-ref.md): Reference a host-managed file in a tool's schema
- [generateHelpers](https://skybridge-staging-qchuchu-ext-apps-host-styles.mintlify.site/api-reference/generate-helpers.md): Generate typed hooks inferred from your server
- [mcpAuthMetadataRouter](https://skybridge-staging-qchuchu-ext-apps-host-styles.mintlify.site/api-reference/mcp-auth-metadata-router.md): Advertise your authorization server for client discovery
- [McpServer](https://skybridge-staging-qchuchu-ext-apps-host-styles.mintlify.site/api-reference/mcp-server.md): Build and run a Skybridge MCP server
- [optionalBearerAuth](https://skybridge-staging-qchuchu-ext-apps-host-styles.mintlify.site/api-reference/optional-bearer-auth.md): Accept a signed-in user when present, allow anonymous otherwise
- [Overview](https://skybridge-staging-qchuchu-ext-apps-host-styles.mintlify.site/api-reference/overview.md): Every server API, hook, and utility, with host compatibility.
- [registerTool](https://skybridge-staging-qchuchu-ext-apps-host-styles.mintlify.site/api-reference/register-tool.md): Register a tool, with or without a view
- [requireBearerAuth](https://skybridge-staging-qchuchu-ext-apps-host-styles.mintlify.site/api-reference/require-bearer-auth.md): Require a signed-in user on every request
- [stytchProvider](https://skybridge-staging-qchuchu-ext-apps-host-styles.mintlify.site/api-reference/stytch-provider.md): Wire OAuth from Stytch Connected Apps
- [useAppsSdkContext](https://skybridge-staging-qchuchu-ext-apps-host-styles.mintlify.site/api-reference/use-apps-sdk-context.md): Read a raw ChatGPT host global by key
- [useCallTool](https://skybridge-staging-qchuchu-ext-apps-host-styles.mintlify.site/api-reference/use-call-tool.md): Call a tool from a view
- [useDisplayMode](https://skybridge-staging-qchuchu-ext-apps-host-styles.mintlify.site/api-reference/use-display-mode.md): Read and switch how the host lays out the view
- [useDownload](https://skybridge-staging-qchuchu-ext-apps-host-styles.mintlify.site/api-reference/use-download.md): Save files from a view to the user's device
- [useFiles](https://skybridge-staging-qchuchu-ext-apps-host-styles.mintlify.site/api-reference/use-files.md): Upload, pick, and resolve files from the host
- [useLayout](https://skybridge-staging-qchuchu-ext-apps-host-styles.mintlify.site/api-reference/use-layout.md): Fit the view to the host's surface
- [useMcpAppContext](https://skybridge-staging-qchuchu-ext-apps-host-styles.mintlify.site/api-reference/use-mcp-app-context.md): Read a raw MCP Apps host context value by key
- [useOpenExternal](https://skybridge-staging-qchuchu-ext-apps-host-styles.mintlify.site/api-reference/use-open-external.md): Open a URL outside the view's iframe through the host
- [useRegisterViewTool](https://skybridge-staging-qchuchu-ext-apps-host-styles.mintlify.site/api-reference/use-register-view-tool.md): Expose a tool the host and model can call against the running view
- [useRequestClose](https://skybridge-staging-qchuchu-ext-apps-host-styles.mintlify.site/api-reference/use-request-close.md): Dismiss the view from inside your app
- [useRequestModal](https://skybridge-staging-qchuchu-ext-apps-host-styles.mintlify.site/api-reference/use-request-modal.md): Open the view as a modal overlay and read its modal state
- [useRequestSize](https://skybridge-staging-qchuchu-ext-apps-host-styles.mintlify.site/api-reference/use-request-size.md): Ask the host to resize the view to fit its content
- [useSendFollowUpMessage](https://skybridge-staging-qchuchu-ext-apps-host-styles.mintlify.site/api-reference/use-send-follow-up-message.md): Post a user message to the conversation from a view interaction
- [useSetOpenInAppUrl](https://skybridge-staging-qchuchu-ext-apps-host-styles.mintlify.site/api-reference/use-set-open-in-app-url.md): Set where the host's Open in app button navigates
- [useToolInfo](https://skybridge-staging-qchuchu-ext-apps-host-styles.mintlify.site/api-reference/use-tool-info.md): Read the tool call that produced the current view
- [useUser](https://skybridge-staging-qchuchu-ext-apps-host-styles.mintlify.site/api-reference/use-user.md): Read the host's locale and device capabilities
- [useViewState](https://skybridge-staging-qchuchu-ext-apps-host-styles.mintlify.site/api-reference/use-view-state.md): Persist view state across remounts and share it with the model
- [Type Utilities](https://skybridge-staging-qchuchu-ext-apps-host-styles.mintlify.site/api-reference/utility-types.md): Type your own code from your server's tools
- [Verifier](https://skybridge-staging-qchuchu-ext-apps-host-styles.mintlify.site/api-reference/verifier.md): Validate access tokens for the bearer-auth middleware
- [workosProvider](https://skybridge-staging-qchuchu-ext-apps-host-styles.mintlify.site/api-reference/workos-provider.md): Wire OAuth from WorkOS AuthKit
- [Authenticate Users](https://skybridge-staging-qchuchu-ext-apps-host-styles.mintlify.site/build/auth.md): Know who's behind every tool call
- [Build Your App](https://skybridge-staging-qchuchu-ext-apps-host-styles.mintlify.site/build/index.md): The four decisions that make an MCP App
- [Manage State](https://skybridge-staging-qchuchu-ext-apps-host-styles.mintlify.site/build/state.md): Decide what the model sees
- [Register Tools](https://skybridge-staging-qchuchu-ext-apps-host-styles.mintlify.site/build/tools.md): Define what humans and agents can do
- [Create Views](https://skybridge-staging-qchuchu-ext-apps-host-styles.mintlify.site/build/view.md): Craft interactive UIs rendered in conversation
- [Examples](https://skybridge-staging-qchuchu-ext-apps-host-styles.mintlify.site/examples.md): Demo apps built with Skybridge
- [Auth0](https://skybridge-staging-qchuchu-ext-apps-host-styles.mintlify.site/examples/auth-auth0.md): Full OAuth authentication with Auth0 and personalized coffee shop search.
- [Clerk](https://skybridge-staging-qchuchu-ext-apps-host-styles.mintlify.site/examples/auth-clerk.md): Full OAuth authentication with Clerk and personalized coffee shop search.
- [Descope](https://skybridge-staging-qchuchu-ext-apps-host-styles.mintlify.site/examples/auth-descope.md): Full OAuth authentication with Descope and personalized coffee shop search.
- [Stytch](https://skybridge-staging-qchuchu-ext-apps-host-styles.mintlify.site/examples/auth-stytch.md): Full OAuth authentication with Stytch and personalized coffee shop search.
- [WorkOS](https://skybridge-staging-qchuchu-ext-apps-host-styles.mintlify.site/examples/auth-workos.md): Full OAuth authentication with WorkOS AuthKit and personalized coffee shop search.
- [Capitals Explorer](https://skybridge-staging-qchuchu-ext-apps-host-styles.mintlify.site/examples/capitals.md): Interactive world map with geolocation and dynamic capital exploration.
- [ChatGPT Files](https://skybridge-staging-qchuchu-ext-apps-host-styles.mintlify.site/examples/chatgpt-files.md): Pick a file from the filesystem or the ChatGPT library and zip it
- [Chess](https://skybridge-staging-qchuchu-ext-apps-host-styles.mintlify.site/examples/chess.md): Play chess against the assistant with view-provided tools
- [Ecommerce Carousel](https://skybridge-staging-qchuchu-ext-apps-host-styles.mintlify.site/examples/ecommerce-carousel.md): Product carousel with persistent cart, localization, and modal checkout flow.
- [Everything](https://skybridge-staging-qchuchu-ext-apps-host-styles.mintlify.site/examples/everything.md): Comprehensive playground showcasing Skybridge hooks and utilities.
- [Flight Booking](https://skybridge-staging-qchuchu-ext-apps-host-styles.mintlify.site/examples/flight-booking.md): Flight search carousel with route details, pricing comparison, and external booking links.
- [Generative UI](https://skybridge-staging-qchuchu-ext-apps-host-styles.mintlify.site/examples/generative-ui.md): LLM-generated dynamic UIs with json-render and shadcn/ui components.
- [Investigation Game](https://skybridge-staging-qchuchu-ext-apps-host-styles.mintlify.site/examples/investigation-game.md): Interactive murder mystery game for MCP Apps
- [Manifest UI](https://skybridge-staging-qchuchu-ext-apps-host-styles.mintlify.site/examples/manifest-ui.md): Manifest UI is an agentic component library for building rich, interactive views.
- [Productivity](https://skybridge-staging-qchuchu-ext-apps-host-styles.mintlify.site/examples/productivity.md): Data visualization dashboard for MCP Apps
- [Starter](https://skybridge-staging-qchuchu-ext-apps-host-styles.mintlify.site/examples/starter.md): The default app scaffolded by `npm create skybridge`. A guided onboarding tour through Skybridge's core APIs.
- [Supabase Triplog](https://skybridge-staging-qchuchu-ext-apps-host-styles.mintlify.site/examples/supabase-triplog.md): Supabase-backed personal trip log with CRUD tools, filtering, and a rich carousel view.
- [Time's Up](https://skybridge-staging-qchuchu-ext-apps-host-styles.mintlify.site/examples/times-up.md): Word-guessing party game for MCP Apps
- [Architecture](https://skybridge-staging-qchuchu-ext-apps-host-styles.mintlify.site/get-started/architecture.md): Design conversational experiences leveraging model intelligence
- [Start building with Skybridge](https://skybridge-staging-qchuchu-ext-apps-host-styles.mintlify.site/get-started/introduction.md): Everything you need to build MCP Apps that run in ChatGPT and Claude
- [Quickstart](https://skybridge-staging-qchuchu-ext-apps-host-styles.mintlify.site/get-started/quickstart.md): Build, test, and deploy your first MCP App
- [Connect an Identity Provider](https://skybridge-staging-qchuchu-ext-apps-host-styles.mintlify.site/guides/auth-providers.md): Wire sign-in through a hosted OAuth provider
- [Configure CSP](https://skybridge-staging-qchuchu-ext-apps-host-styles.mintlify.site/guides/csp.md): Let your views reach the domains they need
- [Handle Files](https://skybridge-staging-qchuchu-ext-apps-host-styles.mintlify.site/guides/files.md): Move files in and out of your app
- [Guides](https://skybridge-staging-qchuchu-ext-apps-host-styles.mintlify.site/guides/index.md): Cross-cutting how-tos for building MCP Apps
- [Migrate to Skybridge](https://skybridge-staging-qchuchu-ext-apps-host-styles.mintlify.site/guides/migrate.md): Bring an existing MCP App over, whatever it's built on
- [Serve Skills over MCP](https://skybridge-staging-qchuchu-ext-apps-host-styles.mintlify.site/guides/skills.md): Ship Agent Skills alongside your server
- [UX Design](https://skybridge-staging-qchuchu-ext-apps-host-styles.mintlify.site/guides/ux.md): Account for what makes an MCP App different
- [Apps SDK and MCP Apps](https://skybridge-staging-qchuchu-ext-apps-host-styles.mintlify.site/resources/apps-sdk-and-mcp-apps.md): How ChatGPT and other hosts run your views, and what Skybridge unifies
- [Telemetry](https://skybridge-staging-qchuchu-ext-apps-host-styles.mintlify.site/resources/telemetry.md): What Skybridge collects, why, and how to opt out
- [Deploy](https://skybridge-staging-qchuchu-ext-apps-host-styles.mintlify.site/ship/deploy.md): Take your app to production
- [Ship](https://skybridge-staging-qchuchu-ext-apps-host-styles.mintlify.site/ship/index.md): Deploy and version your app
- [Version Your App](https://skybridge-staging-qchuchu-ext-apps-host-styles.mintlify.site/ship/versioning.md): Run several versions of one app on the same domain
- [Audit](https://skybridge-staging-qchuchu-ext-apps-host-styles.mintlify.site/test/audit.md): Catch spec and platform issues before submission
- [DevTools](https://skybridge-staging-qchuchu-ext-apps-host-styles.mintlify.site/test/devtools.md): Call tools and render views locally, without a host
- [Test Your App](https://skybridge-staging-qchuchu-ext-apps-host-styles.mintlify.site/test/index.md): Pick the right tool for what you're testing
- [Playground](https://skybridge-staging-qchuchu-ext-apps-host-styles.mintlify.site/test/playground.md): Chat with a real model running your app
- [Connect to Hosts](https://skybridge-staging-qchuchu-ext-apps-host-styles.mintlify.site/test/tunnel.md): Tunnel your local server to ChatGPT and Claude
- [Troubleshooting](https://skybridge-staging-qchuchu-ext-apps-host-styles.mintlify.site/troubleshooting.md): Fix the errors you're most likely to hit