Axad for developers
Axad is an AI language tutor. Inside your agent, your own model is the tutor, and Axad gives it what a tutor needs: a library of lessons and practice exams, the learner's flash cards with spaced review, learning widgets, voice and pictures, and step-by-step runbooks. The learner's cards and place follow them to every agent and to the Axad app for Mac.
Connect an agent
Axad's MCP server is a remote server over streamable HTTP. Add this URL as a custom connector, with no key to paste:
https://mcp.axad.ai/mcp
- Claude: Customize › Connectors › Add custom connector › paste the URL.
- ChatGPT: Plugins › Add custom MCP server › paste the URL.
- Codex:
codex mcp add axad --url https://mcp.axad.ai/mcp - Claude Code:
claude mcp add --transport http axad https://mcp.axad.ai/mcp
The server speaks MCP versions 2025-06-18, 2025-11-25 and 2026-07-28, and renders its learning widgets as an MCP Apps view in hosts that show one. Hosts with no view (Codex, Claude Code) get the widget's content as text, and Axad's skills tell the model how to write it.
Claude's directory listing uses a profile with fewer tools (no picture or speech that costs credit): https://mcp.axad.ai/directory/mcp.
Sign-in
A host connects without signing in. Tools that need no account (browsing the library, trying every widget, finding pictures) work at once. The first call of a tool that needs the learner's account answers 401 with the resource metadata, and the host signs the learner in once.
- OAuth 2.1 authorization code with PKCE (S256), public clients, scope
axad. - Client registration: Dynamic Client Registration (RFC 7591) at
https://axad.ai/v1/oauth/register, or a Client ID Metadata Document as theclient_id. - Protected resource metadata (RFC 9728):
https://mcp.axad.ai/.well-known/oauth-protected-resource. Authorization server metadata (RFC 8414):https://axad.ai/.well-known/oauth-authorization-server. - Access tokens live 1 hour. Refresh tokens live 60 days and work once. The learner signs in on axad.ai with Apple, Google or an emailed code.
Tools
40 tools, in the order the server lists them. "Account" means the tool needs the learner's sign-in. Every tool has a title and read-only and destructive hints. Each result carries structuredContent and the same object as JSON text.
| Tool | Title | Needs | Changes data |
|---|---|---|---|
browse_catalog | Browse Axad's lessons | Nothing | No |
open_lesson | Open a lesson | Account | Yes |
list_lessons | My lessons | Account | No |
read_page | Read a lesson page | Account | Yes |
close_lesson | Close a lesson | Account | Yes |
save_cards | Save to my cards | Account | Yes |
due_cards | Cards to review | Account | No |
review_card | Record a review | Account | Yes |
speak | Say it aloud | Account | Yes |
list_runbooks | Learning paths | Nothing | No |
start_runbook | Start a learning path | Account | Yes |
next_step | Current step | Account | No |
record_step | Finish a step | Account | Yes |
get_account | My Axad account | Account | No |
upgrade_link | Plans and credit | Nothing | No |
redeem_gift | Redeem a gift code | Account | Yes |
search_bag | Search my cards | Account | No |
find_images | Find pictures | Nothing | No |
nominate_image | Get a picture | Account | Yes |
21 learning widgets, each a show_ tool that needs no sign-in and changes nothing: show_gloss_chunks, show_examples, show_alternatives, show_explain, show_tips, show_contrast, show_pattern, show_forms, show_correction, show_quiz, show_shadow, show_voice, show_picture, show_dialogue, show_sentence_frame, show_register, show_exam_task, show_scene, show_visual, show_custom, show_next.
Plugins
The Axad plugin bundles the MCP server with Axad's teaching skills, for Claude and for ChatGPT and Codex.
/plugin marketplace add axad-ai/plugins
/plugin install axad@axad
In Claude Code. In Claude Desktop: Customize › Plugins › Add › Add marketplace.
codex plugin marketplace add axad-ai/plugins
In Codex, then install Axad from /plugins. The plugins are built from one source: github.com/axad-ai/plugins. The server is also listed in the official MCP Registry as ai.axad/axad.
REST API and OpenAPI
The same learner data is open over HTTPS and JSON at https://api.axad.ai/v1, with the OAuth access token above as a bearer token: lessons, cards and reviews, speech, pictures, the account. The description is an OpenAPI 3.1 document: openapi.json.
Limits
Plans cap two things, and nothing is deleted because of a cap: a call past one answers limit_reached and the learner closes a lesson, removes cards or upgrades.
| Plan | Cards | Active lessons |
|---|---|---|
| Free | 20 | 1 |
| Free, with a saved card | 30 | 1 |
| $10 a month | 50 | 1 |
| $30 a month | 500 | 10 |
| $50 a month | Unlimited | Unlimited |
Teaching through an agent costs no credit: the agent's own model does it. Speech and new drawings spend the account's credit; with none left they answer allowance_spent, and the rest keeps working.
- Emailed sign-in codes: 5 sends an hour to one address and 20 from one network; a code dies after 5 wrong tries.
- OAuth client registrations: 60 an hour from one network. Client metadata documents: 30 fetched an hour from one network.
- Gift codes: too many wrong codes in an hour answer 429
gift_tries. - No other call has a fixed quota today. A 429 means slow down.
Support
Write to support@axad.ai about the server, the plugins or the API. Privacy: axad.ai/privacy. Terms: axad.ai/terms.