Skip to main content

​
Public documentation

Read Orq.ai documentation and use the documentation MCP server at https://docs.orq.ai/mcp without authentication. Discover API schemas and the documentation MCP server through the capability catalog.

​
API credential provisioning

For agents calling the Orq.ai API at https://my.orq.ai, provision credentials before making API requests:
  1. Create an account at Sign up, or sign in to an existing workspace.
  2. Create a project-scoped API key. Use a service account key for production automation; creating one requires a workspace admin.
  3. Grant the permissions required by the agent and store the key securely.
  4. Send the key in the request header:
Use the OpenAPI specification to discover operations and their authentication requirements. Manage, revoke, or replace API keys through Settings > API Keys; see Secrets management for rotation instructions.

​
Workspace MCP authorization

Connect an OAuth-capable MCP client to https://my.orq.ai/v2/mcp and complete the browser sign-in and workspace consent flow. An existing API key can also authenticate requests to this endpoint.
  • Resource metadata: https://my.orq.ai/.well-known/oauth-protected-resource/v2/mcp
  • Authorization server metadata: https://my.orq.ai/.well-known/oauth-authorization-server/v2/auth/mcp
  • OAuth issuer: https://my.orq.ai/v2/auth/mcp
  • OAuth client registration: https://my.orq.ai/v2/auth/mcp/register
  • Supported grants: authorization_code and refresh_token, with PKCE S256 required for authorization.
OAuth client registration registers an MCP client; it does not create an Orq.ai user or workspace. Read the discovery documents for supported scopes and current authorization, token, and revocation endpoints. See the workspace MCP guide for client setup.