axis-erp-mcp

MCP server for the Axis Colleges ERP. Thin client over the axis-platform REST API — no ERP scraping, no passwords, no sessions on disk.

Use (product-page snippet)

{
  "mcpServers": {
    "axis": {
      "command": "npx.cmd",
      "args": ["--package=axis-erp-mcp@1", "axis-erp-mcp"],
      "env": { "AXIS_API_KEY": "axis_paste-your-key-here" }
    }
  }
}

macOS/Linux: "command": "npx". Get the key on the product page; the server exits(1) with instructions if it's missing.

Tools (6, reads only)

| Tool | Answers | Backend | |---|---|---| | attendance | my attendance (present/absent/total + status) | /v1/attendance/report | | today | what do I have today | /v1/today | | timetable | weekly class grid | /v1/timetable | | exam_results | types bare, marksheet with exam id | /v1/exam/* | | inbox | notices, dues, grievances | /v1/notices + /v1/fees/dues + /v1/grievances | | profile | who am I (once per session) | /v1/me |

Every response carries as_of; arrays capped at 10 + has_more; detail:true returns full rows. roll is resolved server-side from /v1/me — never in a schema.

Dev

npm install
npm run build            # strict tsc → dist/
npm run smoke            # needs AXIS_API + AXIS_API_KEY env, 6 live tests
npm publish --access public