Metadata-Version: 2.4
Name: academy-mcp
Version: 0.1.0
Summary: Stdio MCP server for authoring academy learning content (personal plans, courses, modules, lessons, pages) via the academy backend MCP API.
Project-URL: Homepage, https://github.com/job-escape/academy_backend
Project-URL: Repository, https://github.com/job-escape/academy_backend
Author-email: JobEscape <margulan@jobescape.me>
License: MIT
Keywords: academy,jobescape,mcp,model-context-protocol
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.10
Requires-Dist: httpx>=0.27
Requires-Dist: mcp>=1.2.0
Description-Content-Type: text/markdown

# academy-mcp

Stdio MCP server for authoring academy learning content — personal plans, categories, courses,
modules, module items (lessons/automations/projects/assistants), EduPages (MDX), and practice pages —
through the academy backend's MCP API.

It is a thin proxy: it fetches the tool list from your backend and forwards every tool call over
HTTPS, authenticating with a per-user API key. No data lives in the client.

## Install / configure

Add to your MCP client config (e.g. Claude Desktop / Claude Code):

    {
      "mcpServers": {
        "academy": {
          "command": "uvx",
          "args": ["academy-mcp"],
          "env": {
            "ACADEMY_MCP_BASE_URL": "https://stage.api.academy.jobescape.me",
            "ACADEMY_MCP_TOKEN": "amk_your_key_here"
          }
        }
      }
    }

| Env var | Meaning |
|---|---|
| `ACADEMY_MCP_BASE_URL` | Base URL of the academy backend (no trailing `/mcp`). Stage: `https://stage.api.academy.jobescape.me`. |
| `ACADEMY_MCP_TOKEN` | Your personal MCP key (starts with `amk_`). Generate it on the MDX editor's **MCP keys** settings page; it is shown once. |

All actions taken through the MCP are attributed to your user and audit-logged on the backend.
