# Muvia

> Muvia is an industrial data platform. This site documents its public REST API (read-only company data over an `mvk_` API key) and its MCP server (tools for AI agents: read, query and, with approval, write). An agent holding only an `mvk_` key and the domain muviabi.com can learn everything it needs here.

Start with the Agent quickstart: it walks the whole path with complete requests and responses.

## Guides

- [Agent quickstart](https://developers.muviabi.com/guides/agent-quickstart.md): The whole path for an AI agent, REST and MCP, with complete requests and responses.
- [Getting started](https://developers.muviabi.com/guides/getting-started.md): Get an API key and make your first request in minutes.
- [MCP server](https://developers.muviabi.com/guides/mcp-server.md): Tools for AI assistants and agents: endpoint, authentication, read and write tools, approvals.
- [Authentication](https://developers.muviabi.com/guides/authentication.md): The X-Api-Key header, the key format, expiry and revocation.
- [Scopes](https://developers.muviabi.com/guides/scopes.md): Which scope each endpoint needs, and how modules cap a key.
- [Errors](https://developers.muviabi.com/guides/errors.md): The error envelope and every error code you can receive.
- [Pagination](https://developers.muviabi.com/guides/pagination.md): Paging through lists and through a dataset's rows.
- [Rate limits](https://developers.muviabi.com/guides/rate-limits.md): Per-key and per-company limits, 429 responses and backing off.
- [Webhooks](https://developers.muviabi.com/guides/webhooks.md): Signed event deliveries pushed to your endpoint, and how to verify them.
- [Versioning](https://developers.muviabi.com/guides/versioning.md): How the API evolves within v1 without breaking your integration.

## Reference

- [OpenAPI specification](https://developers.muviabi.com/openapi.json): every REST operation, with x-muvia-effect (read or write) and x-muvia-quota.
- [Interactive API reference](https://developers.muviabi.com/reference): the same specification, rendered for people.
- [Changelog](https://developers.muviabi.com/changelog): every change to the public API, newest first.

## MCP

- [MCP server](https://developers.muviabi.com/guides/mcp-server.md): endpoint, authentication, tool annotations and how writes are confirmed.
- [Agent quickstart](https://developers.muviabi.com/guides/agent-quickstart.md): initialize, list tools, call whoami and query_sql.
- [MCP tools](https://developers.muviabi.com/mcp-tools.md): every tool of the MCP server, whether it reads or writes, and its arguments.

## Optional

- [All guides in one file](https://developers.muviabi.com/llms-full.txt): every guide concatenated as Markdown.