# Sunny Developers

> Build on Sunny: a hosted MCP server, a REST API, OAuth 2.1, a layout format, embeds, and webhooks.

Authenticate with OAuth 2.1 (authorization code + PKCE) or an API key in the `x-api-key` header.
REST API base URL: https://api.sunnysdk.com. Hosted MCP server: https://agents.sunnysdk.com/mcp.
Every page below is also available as Markdown at https://sunnysdk.com/docs/<page>.md.

## Documentation Sets

- [Abridged documentation](https://sunnysdk.com/docs/llms-small.txt): a compact version of the documentation for Sunny Developers, with non-essential content removed
- [Complete documentation](https://sunnysdk.com/docs/llms-full.txt): the full documentation for Sunny Developers
- [MCP server](https://sunnysdk.com/docs/_llms-txt/mcp-server.txt): connect an MCP client, discovery, every tool and its scope, and limits
- [REST API](https://sunnysdk.com/docs/_llms-txt/rest-api.txt): OpenAPI documents, OAuth and API-key authentication, the /v1 surface, conventions, and rate limits
- [TypeScript SDK](https://sunnysdk.com/docs/_llms-txt/typescript-sdk.txt): @sunnysdk/client: install, authentication, resource methods, errors, pagination, and webhooks
- [OAuth and scopes](https://sunnysdk.com/docs/_llms-txt/oauth-and-scopes.txt): discovery, client registration (CIMD), every scope, consent, revocation, and token lifetime
- [Layout format](https://sunnysdk.com/docs/_llms-txt/layout-format.txt): the sunny-layout JSON document and how to export and import it
- [Embeds](https://sunnysdk.com/docs/_llms-txt/embeds.txt): iframe surfaces, the postMessage protocol, embed.js, and embed tokens
- [Webhooks](https://sunnysdk.com/docs/_llms-txt/webhooks.txt): events, delivery format, signature verification, retries, and the endpoint API
- [Inbound webhook URLs](https://sunnysdk.com/docs/_llms-txt/inbound-webhook-urls.txt): sending order files to a workspace webhook URL

## Notes

- The complete documentation includes all content from the official documentation
- The content is automatically generated from the same source as the official documentation

## Optional

- [API reference (/v1, beta)](https://sunnysdk.com/docs/api-reference.md): every /v1 operation, its parameters, schemas and errors, as Markdown
- [OpenAPI document (App API, unstable)](https://api.sunnysdk.com/openapi.json)
- [OpenAPI document (/v1, beta)](https://api.sunnysdk.com/v1/openapi.json)
- [auth.md](https://api.sunnysdk.com/auth.md): registration and authentication guide for agents
