---
title: JoAi developer resources
description: Machine-readable JoAi entry points — OpenAPI, MCP, OAuth scopes, and docs.joai.ai links.
canonical: https://joai.ai/developers.md
last-updated: 2026-09-19
---

# JoAi developer resources

Entry points for agents and developers integrating with JoAi. Prefer [docs.joai.ai](https://docs.joai.ai) for product usage and this file for discovery URLs.

## Specs & discovery

| Resource | URL |
| --- | --- |
| OpenAPI | https://joai.ai/openapi.json |
| API catalog | https://joai.ai/.well-known/api-catalog |
| Auth walkthrough | https://joai.ai/auth.md |
| Homepage markdown | https://joai.ai/index.md |
| OpenAPI (YAML) | https://joai.ai/api/openapi.yaml |
| llms.txt | https://joai.ai/llms.txt |
| SKILL.md | https://joai.ai/SKILL.md |
| Setup prompt | https://joai.ai/prompts/setup-agent.md |
| Pricing | https://joai.ai/pricing.md |
| ARD catalog | https://joai.ai/.well-known/ard.json |
| Agent skills index | https://joai.ai/.well-known/agent-skills/index.json |
| MCP server card | https://joai.ai/.well-known/mcp/server-card.json |
| A2A agent card | https://joai.ai/.well-known/agent-card.json |
| Agents cold start | https://joai.ai/agents.md |
| Docs index | https://joai.ai/docs/llms.txt |
| API index | https://joai.ai/api/llms.txt |
| OAuth authorization server | https://joai.ai/.well-known/oauth-authorization-server |
| OAuth protected resource (MCP) | https://joai.ai/.well-known/oauth-protected-resource |
| Cortex OAuth discovery | https://cortex.joai.ai/.well-known/oauth-authorization-server |
| Public agents | https://api.joai.ai/.well-known/agents.json |

## OAuth scopes

| Scope | Meaning |
| --- | --- |
| `mcp:read` | Read MCP tools and resources |
| `mcp:write` | Mutating MCP tools |
| `mcp:use` | Full MCP use (read + write) |

Declared in OpenAPI security schemes and `scopes_supported` on the OAuth metadata URLs above. Prefer least privilege.

## Product docs

| Topic | URL |
| --- | --- |
| Getting started | https://docs.joai.ai/introduction/getting-started |
| API & tokens | https://docs.joai.ai/api |
| MCP protocol | https://docs.joai.ai/protocols/mcp |
| MCP connect | https://docs.joai.ai/integrations/mcp |
| Webhooks | https://docs.joai.ai/webhooks |
| Billing | https://docs.joai.ai/billing |
| Integrations | https://docs.joai.ai/integrations/ |

## Bases

- Website: https://joai.ai
- Docs: https://docs.joai.ai
- API: https://api.joai.ai/api/v1
- Cortex MCP: https://cortex.joai.ai/mcp