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 the client_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.

ToolTitleNeedsChanges data
browse_catalogBrowse Axad's lessonsNothingNo
open_lessonOpen a lessonAccountYes
list_lessonsMy lessonsAccountNo
read_pageRead a lesson pageAccountYes
close_lessonClose a lessonAccountYes
save_cardsSave to my cardsAccountYes
due_cardsCards to reviewAccountNo
review_cardRecord a reviewAccountYes
speakSay it aloudAccountYes
list_runbooksLearning pathsNothingNo
start_runbookStart a learning pathAccountYes
next_stepCurrent stepAccountNo
record_stepFinish a stepAccountYes
get_accountMy Axad accountAccountNo
upgrade_linkPlans and creditNothingNo
redeem_giftRedeem a gift codeAccountYes
search_bagSearch my cardsAccountNo
find_imagesFind picturesNothingNo
nominate_imageGet a pictureAccountYes

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.

PlanCardsActive lessons
Free201
Free, with a saved card301
$10 a month501
$30 a month50010
$50 a monthUnlimitedUnlimited

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.