# FieldRobin developer resources

FieldRobin provides a versioned REST API, a public OpenAPI document, an OAuth-protected Streamable HTTP MCP server, and machine-readable AI discovery documents.

## REST API

- [Public OpenAPI 3.1 document](https://fieldrobin.com/openapi.json)
- [API versioning and deprecation policy](https://fieldrobin.com/api-versioning.md)
- Base URL: https://fieldrobin.com/api/v1
- Errors use a JSON envelope with code, message, resolution, and status fields.
- Rate limits use RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset, and RateLimit-Policy. A 429 response includes Retry-After.

## MCP

- [MCP server card](https://fieldrobin.com/.well-known/mcp/server-card.json)
- [MCP server card alias](https://fieldrobin.com/.well-known/mcp.json)
- Streamable HTTP endpoint: https://fieldrobin.com/api/v1/mcp
- [Protected resource metadata](https://fieldrobin.com/.well-known/oauth-protected-resource)
- [Authorization server metadata](https://fieldrobin.com/.well-known/oauth-authorization-server)
- [OAuth and MCP authentication guide](https://fieldrobin.com/auth.md)
- [Webhook integration guide](https://fieldrobin.com/webhooks.md)

## CLI

The official CLI package is maintained at packages/fieldrobin-cli with the npm name @fieldrobin/cli. It uses the public REST API and discovery documents. npm publication is pending release credentials.

## Other discovery documents

- [Agent index](https://fieldrobin.com/llms.txt)
- [Full agent index](https://fieldrobin.com/llms-full.txt)
- [API catalog](https://fieldrobin.com/.well-known/api-catalog)
- [OAuth guide](https://fieldrobin.com/auth.md)
- [Webhook guide](https://fieldrobin.com/webhooks.md)
- [Public documentation](https://docs.fieldrobin.com/)

Authenticated workspace routes and customer data are not public discovery resources.
