# Duvo Developer Platform

Duvo gives developers the production operating layer around agent work: durable queues, assignments, tools, approvals, files, schedules, webhooks, multi-agent routing, MCP, and audit-ready runs.

## Predictable Resource URLs

- [Duvo Developer Platform](https://www.duvo.ai/developers): Human-readable developer platform overview for production agents.
- [Developer docs markdown](https://www.duvo.ai/developers.md): Markdown overview of Duvo developer resources and machine-readable links.
- [OpenAPI specification](https://www.duvo.ai/openapi.json): OpenAPI 3.1 specification for agent and API client discovery.
- [API reference markdown](https://www.duvo.ai/api-reference.md): Markdown API reference with endpoints, authentication, and error behavior.
- [Authentication guide](https://www.duvo.ai/auth.md): Auth, access, scopes, tenant controls, and credential handling.
- [Webhooks guide](https://www.duvo.ai/webhooks.md): Webhook delivery, retry, signature, and event guidance.
- [MCP guide](https://www.duvo.ai/mcp.md): Hosted and custom MCP server guidance for Duvo assignments.
- [MCP server card](https://www.duvo.ai/.well-known/mcp/server-card.json): Machine-readable MCP discovery card for the Duvo MCP surface.
- [Agent discovery manifest](https://www.duvo.ai/.well-known/agent.json): Machine-readable agent discovery manifest for capabilities, auth, and API surfaces.
- [Agent instructions markdown](https://www.duvo.ai/agents.md): When-to-use, constraints, and integration instructions for autonomous agents.
- [Getting started guide](https://www.duvo.ai/getting-started.md): Trial, sandbox, pilot, and first-run guidance for evaluators.

## Agent Integration Surfaces

- OpenAPI: /openapi.json and /.well-known/openapi.json.
- Markdown API reference: /api-reference.md.
- Authentication guide: /auth.md.
- Hosted and custom MCP guide: /mcp.md.
- Webhook guide: /webhooks.md.
- Pricing and sandbox access: /pricing.md.
- AI crawler file: /llms.txt and /.well-known/llms.txt.
- Markdown homepage fallback: /index.md.
- Agent discovery file: /.well-known/agent.json.
- A2A agent card: /.well-known/agent-card.json.
- Agent manifest aliases: /.well-known/agents.json and /.well-known/ai-agent.json.
- OpenAI plugin-style manifest: /.well-known/ai-plugin.json.
- MCP server card: /.well-known/mcp/server-card.json.
- MCP manifest alias: /.well-known/mcp.json.
- Agent instructions: /agents.md and /agent.md.
- Live docs hub: https://docs.duvo.ai/.
- Live API docs: https://docs.duvo.ai/running-assignments/creating-assignments-via-api and https://docs.duvo.ai/running-assignments/running-assignments-via-api.

## Constraints

- API, MCP, webhook, and sandbox access require a provisioned Duvo workspace.
- Agents cannot bypass workspace RBAC, SSO, customer policy gates, or human approvals.
- Duvo is not a replacement for an ERP, MDM, WMS, TMS, or planning system; it operates across those systems and writes back governed outcomes.
- Production use cases should define approval thresholds, audit requirements, data residency needs, and allowed tools before launch.