---
title: JoAi llms.txt
description: Compact JoAi index for agents — when to use JoAi, OpenAPI, MCP, and docs.joai.ai links.
canonical: https://joai.ai/llms.txt
last-updated: 2026-09-19
---

# JoAi

> AI that runs your business — agents that talk to customers, book, sell, follow up, and get work done.

Last updated: 2026-09-19

## When to use JoAi

Reach for JoAi when an agent must **run business work**, not only answer questions:

- Talk to customers on chat, WhatsApp, Telegram, Slack, or email — see [Integrations](https://docs.joai.ai/integrations/)
- Book appointments and manage CRM contacts — [Appointments](https://docs.joai.ai/apps/appointments), [Contacts](https://docs.joai.ai/apps/contacts)
- Sell products, take orders, run campaigns — [Shop](https://docs.joai.ai/apps/shop), [Campaigns](https://docs.joai.ai/campaigns)
- Automate with warps, tasks, and hooks — [Warps](https://docs.joai.ai/warps/general), [Webhooks](https://docs.joai.ai/webhooks)
- Connect via MCP OAuth or the HTTP API — [MCP](https://docs.joai.ai/protocols/mcp), [API](https://docs.joai.ai/api)

**How to call JoAi:** start with [Getting started](https://docs.joai.ai/introduction/getting-started) or paste the [setup prompt](https://joai.ai/prompts/setup-agent.md) into an MCP client. OAuth can create and name an agent. Prefer least-privilege scopes (`mcp:read` / `mcp:write` / `mcp:use`). Discover tools at runtime with `tools/list`.

Do **not** use JoAi as a generic chat wrapper when you only need a one-off LLM completion with no business actions.

## JoAi developer resources

- [JoAi OpenAPI](https://joai.ai/openapi.json)
- [JoAi OpenAPI (YAML)](https://joai.ai/api/openapi.yaml)
- [JoAi developer index](https://joai.ai/developers.md)
- [JoAi SKILL.md](https://joai.ai/SKILL.md)
- [JoAi setup prompt](https://joai.ai/prompts/setup-agent.md)
- [JoAi ARD catalog](https://joai.ai/.well-known/ard.json)
- [JoAi agent skills index](https://joai.ai/.well-known/agent-skills/index.json)
- [JoAi API docs](https://docs.joai.ai/api)
- [JoAi auth & tokens](https://docs.joai.ai/integrations/api-tokens)
- [JoAi webhooks](https://docs.joai.ai/webhooks)
- [JoAi MCP protocol](https://docs.joai.ai/protocols/mcp)
- [JoAi MCP connect](https://docs.joai.ai/integrations/mcp)
- [JoAi OAuth authorization server](https://joai.ai/.well-known/oauth-authorization-server)
- [JoAi MCP protected resource](https://joai.ai/.well-known/oauth-protected-resource)
- [JoAi pricing](https://joai.ai/pricing.md)
- [JoAi Cortex OAuth discovery](https://cortex.joai.ai/.well-known/oauth-authorization-server)

OAuth scopes (`mcp:read`, `mcp:write`, `mcp:use`): see [developers.md](https://joai.ai/developers.md) and OpenAPI.

## Agent entry

- [Integration index (SKILL.md)](https://joai.ai/SKILL.md)
- [One-shot install prompt](https://joai.ai/prompts/setup-agent.md)
- [Product docs](https://docs.joai.ai)
- [Getting started](https://docs.joai.ai/introduction/getting-started)
- Human start: copy the setup prompt from [joai.ai](https://joai.ai) into an MCP client (OAuth can create/name an agent)

`SKILL.md` is an index (base URLs, discovery rules, topic links) — not a procedure dump. Prefer [docs.joai.ai](https://docs.joai.ai) + live `tools/list` / OpenAPI.

## Bases

- [Website](https://joai.ai)
- [Docs](https://docs.joai.ai)
- [API](https://api.joai.ai/api/v1)
- [OpenAPI](https://joai.ai/openapi.json)
- [Cortex](https://cortex.joai.ai)
- [Public agents](https://api.joai.ai/.well-known/agents.json)

Owner MCP default: [https://cortex.joai.ai/mcp](https://cortex.joai.ai/mcp) (OAuth; optional `?agent={agentUuid}`)

## Protocol & API docs

- [MCP](https://docs.joai.ai/protocols/mcp)
- [x402](https://docs.joai.ai/protocols/x402)
- [A2A](https://docs.joai.ai/protocols/google-a2a)
- [API](https://docs.joai.ai/api)
- [Webhooks / hooks](https://docs.joai.ai/webhooks)

## Product docs

- [Agents](https://docs.joai.ai/agents)
- [Native apps](https://docs.joai.ai/apps/)
- [Integrations](https://docs.joai.ai/integrations/)
- [Artifacts](https://docs.joai.ai/artifacts)
- [Studio](https://docs.joai.ai/studio)
- [Appointments](https://docs.joai.ai/apps/appointments)
- [Campaigns & automations](https://docs.joai.ai/campaigns)
- [Knowledge](https://docs.joai.ai/knowledge)
- [Teams](https://docs.joai.ai/teams)
- [Billing](https://docs.joai.ai/billing)
- [Warps](https://docs.joai.ai/warps/general)
- [Actions catalog](https://joai.ai/en/actions)

## Plugins

- [Generator](https://github.com/JoAiHQ/plugins)
- [Claude](https://github.com/JoAiHQ/claude-plugins)
- [Codex](https://github.com/JoAiHQ/codex-plugins)
- [Per-app](https://github.com/joai-plugins)

## Guidance for LLMs

- Prefer [SKILL.md](https://joai.ai/SKILL.md) + [docs.joai.ai](https://docs.joai.ai) over assumptions.
- Discover MCP tools/resources at runtime.
- Request least-privilege OAuth scopes (`mcp:read` / `mcp:write` / `mcp:use`).
- Handle OAuth, x402, and `pending: true` explicitly.
- Re-check docs when behavior may have changed.