# Glotto

> Glotto keeps your developer surface — mobile-first SDKs in 13 languages, docs, and an MCP server — provably correct and in lockstep with your spec, forever.

The full text of every page below is available in one document at https://glotto.dev/llms-full.txt. Any single page is available as clean Markdown by appending `index.md` to its route, or by requesting the route with `Accept: text/markdown`.

## Overview

- [Glotto — SDKs, docs, and MCP from one API spec](https://glotto.dev/index.md)

## Docs

- [Documentation](https://glotto.dev/docs/index.md): Configuration reference, generated SDK guides, and the glotto.yml schema.
- [Agent primitives](https://glotto.dev/docs/agent-primitives/index.md): Token counting, context budgeting, vector math, structured decode and budget-aware retry — emitted with your SDK.
- [Authentication](https://glotto.dev/docs/authentication/index.md): Bearer tokens, API keys, OAuth2 client credentials, and basic auth: how every generated SDK takes credentials, with env-var fallback and typed scopes.
- [Breaking-change detection](https://glotto.dev/docs/breaking-changes/index.md): Every pull request that changes your spec is classified against the last build — which changes break a caller who upgrades, and which do not.
- [CLI reference](https://glotto.dev/docs/cli/index.md): Every command in the published glotto CLI — init, schema, workspace, generate, mcp, verify-attestation, login, logout — with flags and exit codes.
- [C#](https://glotto.dev/docs/csharp/index.md): An idiomatic .NET client that takes the HttpClient you supply, with resource accessors, a CancellationToken on every method, and await foreach paging.
- [Custom code](https://glotto.dev/docs/custom-code/index.md): Add your own code to a generated SDK and keep it across regenerations — customer-owned extensions and patch preservation.
- [Dart](https://glotto.dev/docs/dart/index.md): An idiomatic Dart package with fromJson/toJson models, Stream-based pagination and SSE, plus async token storage and connectivity-aware retries for Flutter.
- [Deployment & single-tenant](https://glotto.dev/docs/deployment/index.md): Run Glotto as the shared SaaS, or as a dedicated single-tenant cell in your own region/VNet running the same control-plane code.
- [Diagnostics configuration](https://glotto.dev/docs/diagnostics-config/index.md): Tune SDK-readiness rules and resolve every glotto.yml validation diagnostic.
- [Fatal diagnostics](https://glotto.dev/docs/diagnostics-fatal/index.md): Fatal configuration, workspace, spec-ingestion, source-retrieval, and transform diagnostics.
- [Migration diagnostics](https://glotto.dev/docs/diagnostics-migrations/index.md): Every diagnostic emitted while migrating from Stainless or Fern, with the required follow-up.
- [Runtime diagnostics](https://glotto.dev/docs/diagnostics-runtime/index.md): Diagnostics raised by generated SDKs at application runtime.
- [SDK generation diagnostics](https://glotto.dev/docs/diagnostics-sdk-generation/index.md): Fatal SDK-generation diagnostics, including reserved and colliding model names across every target.
- [Diagnostics reference](https://glotto.dev/docs/diagnostics/index.md): The SDK-readiness lint rules and the entry point for every GLOTTO_ diagnostic, with severities and resolution guidance.
- [Drift detection](https://glotto.dev/docs/drift-detection/index.md): Generated code is committed to Git, and Glotto fails a PR when the committed output no longer matches what the generator produces.
- [Elixir](https://glotto.dev/docs/elixir/index.md): A functional Elixir Hex package built on Req: struct models, lazy Stream pagination and SSE, and ApiError structs whose kind is a documented atom.
- [Endpoint migration](https://glotto.dev/docs/endpoint-migration/index.md): Rename or re-version an endpoint without breaking your SDK — aliases keep the old method working against the new operation, and deprecated marks it.
- [Errors](https://glotto.dev/docs/errors/index.md): A failed request throws a typed ApiError carrying the status, method, path, parsed body, headers, and request id, plus per-status-family subclasses.
- [File uploads & downloads](https://glotto.dev/docs/file-transfers/index.md): Send files and consume binary responses without losing bytes or metadata.
- [Forward compatibility](https://glotto.dev/docs/forward-compatibility/index.md): A server-added enum value or response field reaches an SDK generated months earlier — without crashing, and without losing data.
- [The generated CLI](https://glotto.dev/docs/generated-cli/index.md): A ready-to-run command-line client for your API: one command per operation, with spec-derived flags, auth, environments, uploads, and retries.
- [The generated docs site](https://glotto.dev/docs/generated-docs-site/index.md): Glotto emits an Astro docs site your customers own — reference pages, multi-language snippets, search, and theming — from the same IR as the SDKs.
- [Getting started](https://glotto.dev/docs/getting-started/index.md): Turn one API spec into SDKs, docs, and an MCP server with Glotto.
- [The Glotto IR](https://glotto.dev/docs/glotto-ir/index.md): GlottoIR is the intermediate representation every codegen target consumes — the single contract between spec ingest and the language engines.
- [glotto.yml API surface](https://glotto.dev/docs/glotto-yml-api-surface/index.md): Control which operations Glotto emits, aliases, streaming behavior, and query serialization.
- [glotto.yml client behavior](https://glotto.dev/docs/glotto-yml-client-behavior/index.md): Configure generated client runtime behavior, transforms, naming, casing, and parameters.
- [glotto.yml model shaping](https://glotto.dev/docs/glotto-yml-model-shaping/index.md): Shape generated models, enum types, required inputs, and auto-populated values.
- [glotto.yml project settings](https://glotto.dev/docs/glotto-yml-project-settings/index.md): Configure diagnostics, code owners, MCP, generated docs, licensing, releases, and hosted binding.
- [glotto.yml reference](https://glotto.dev/docs/glotto-yml/index.md): The complete glotto.yml configuration reference — every key, its shape, and accepted values.
- [Go](https://glotto.dev/docs/go/index.md): An idiomatic Go module: context.Context-first methods, pull pagination, typed errors for errors.As, and unknown response fields kept on decode.
- [The API-surface graph](https://glotto.dev/docs/graph/index.md): A machine-readable graph of your API surface: operations, models, auth schemes, events and the typed edges between them, in one deterministic graph.json.
- [Idempotency keys](https://glotto.dev/docs/idempotency-key/index.md): Glotto treats the Idempotency-Key as a first-class config concept — auto-injected on mutations whose spec advertises it, so retries are safe.
- [Idempotency](https://glotto.dev/docs/idempotency/index.md): Glotto auto-injects a fresh Idempotency-Key UUID on writes, so a retried call can't create two resources — per operation, or for every mutation.
- [Java](https://glotto.dev/docs/java/index.md): A buildable Java library with Gson models, resource sub-clients, CompletableFuture async twins, and unchecked ApiError exceptions — nothing to wrap.
- [Kotlin](https://glotto.dev/docs/kotlin/index.md): A coroutine-first Kotlin client: suspend functions, Flow streaming and pagination, sealed-type errors, plus Android-native and Multiplatform targets.
- [The MCP server](https://glotto.dev/docs/mcp-server/index.md): Glotto generates a multi-mode Model Context Protocol server — Tools Mode, Code Mode, and Dynamic Mode — that your API's consumers point their AI clients at.
- [Migrate from Fern](https://glotto.dev/docs/migrate-from-fern/index.md): Convert a Fern project — generators.yml and docs.yml — to glotto.yml with one command, pin your SDK's member names, and keep every inbound docs link working.
- [Migrate from Stainless](https://glotto.dev/docs/migrate-from-stainless/index.md): Convert a stainless.yml to glotto.yml with one command, review the migration report, and move your SDKs, docs, and MCP server across — custom code kept.
- [Multi-VCS release flow](https://glotto.dev/docs/multi-vcs-release/index.md): Glotto opens regenerate-and-release PRs across GitHub, GitLab, and Bitbucket through one provider-agnostic VCS abstraction.
- [Pagination](https://glotto.dev/docs/pagination/index.md): Iterate results automatically or fetch one typed page at a time.
- [PHP](https://glotto.dev/docs/php/index.md): A Composer-installable PHP SDK with strict_types, resource objects, and a swappable PSR-18 transport — typed ApiError exceptions and lazy paging.
- [The pipeline](https://glotto.dev/docs/pipeline/index.md): How glotto generate composes spec ingest, normalization, IR build, codegen, and release into one deterministic flow.
- [Polling](https://glotto.dev/docs/polling/index.md): Waiting for an async operation to finish with the generated poll helpers.
- [Python](https://glotto.dev/docs/python/index.md): An httpx-based Python SDK with typed dataclasses or pydantic v2 models and both async and sync clients — iterator pagination, SSE streaming, and typed errors.
- [React Native](https://glotto.dev/docs/react-native/index.md): A Hermes-safe, Metro-friendly React Native SDK, not a re-skin of the web client: secure token storage, NetInfo-aware retries, background-aware streams.
- [Retries & timeouts](https://glotto.dev/docs/retries/index.md): Automatic retries with backoff, and how to tune them.
- [Ruby](https://glotto.dev/docs/ruby/index.md): An idiomatic Ruby gem with snake_case resource objects, immutable Data.define models, persistent connections, and rescuable typed error classes.
- [Rust](https://glotto.dev/docs/rust/index.md): An idiomatic Rust crate built on serde types: Result-returning operations with an ApiErrorKind enum to match on, cursor pagination, and SSE streaming.
- [How Glotto compares](https://glotto.dev/docs/sdk-generation-comparison/index.md): Two questions decide an SDK generator: is the output idiomatic, and how do you keep every language in parity? How Glotto compares to the alternatives.
- [The published spec repo](https://glotto.dev/docs/spec-repo/index.md): Your API specification kept in a git repo you own — base, post-transform and code-sample-decorated — provably current on every build, on any of four forges.
- [Streaming](https://glotto.dev/docs/streaming/index.md): Consume server-sent events and streamed responses.
- [Swift](https://glotto.dev/docs/swift/index.md): An idiomatic Swift package of Codable types with throwing operations and an APIErrorKind enum, plus Keychain storage and connectivity-aware retries.
- [Telemetry hooks](https://glotto.dev/docs/telemetry/index.md): Observe every request with the client's log / metric / trace callbacks.
- [The generated Terraform provider](https://glotto.dev/docs/terraform/index.md): A publishable terraform-plugin-framework provider for your API — resources, data sources, Registry docs and acceptance tests, all derived from your spec.
- [Transforms reference](https://glotto.dev/docs/transforms/index.md): The glotto.yml transforms that rewrite your OpenAPI spec for cleaner SDKs, with arguments and examples.
- [TypeScript](https://glotto.dev/docs/typescript/index.md): Glotto's reference target: an ESM-first, tree-shakable TypeScript client with typed error classes, async-iterator pagination, and SSE streaming.
- [Connect a VCS provider](https://glotto.dev/docs/vcs-connect/index.md): Connect GitHub, GitLab, or Bitbucket once, and Glotto tags your downstream repo to publish Go, Swift, and PHP SDKs and open release PRs for you.
- [The verification report](https://glotto.dev/docs/verification-report/index.md): Every regeneration produces a deterministic report: pinned inputs, per-target drift, compile and contract statuses, delivered to CI and the release PR.
- [Webhooks](https://glotto.dev/docs/webhooks/index.md): Verifying inbound webhook signatures with the helpers your SDKs emit when the spec declares webhooks.

## Blog

- [Engineering blog](https://glotto.dev/blog/index.md): How the correctness engine is built, and what we learned building it.

## Changelog

- [Changelog](https://glotto.dev/changelog/index.md): Customer-facing changes to the generated SDKs, docs, and MCP server.

## Legal

- [Privacy Policy](https://glotto.dev/legal/privacy/index.md): How Glotto, Inc. collects, uses, and protects personal data on glotto.dev and in the hosted product, and how to make a data-subject request.
- [Sub-processors](https://glotto.dev/legal/subprocessors/index.md): Every third party that processes Glotto customer or personal data, what it receives, and the region it processes in — plus where your data lives.
- [Terms of Service](https://glotto.dev/legal/terms/index.md): The terms governing use of Glotto's hosted service — accounts, your content, acceptable use, fees, warranties, and termination.