origo-mcp
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
origo-mcp
An MCP (Model Context Protocol) server that gives an AI agent (Claude, or
any other MCP-compatible client) full administrator-level control of the
Origo Abroad platform, by wrapping origo_backend's /admin, /crm, and
/auth REST API as MCP tools.
It authenticates once as an admin/manager/staff account, caches the JWT, and automatically re-authenticates if the token expires. It runs locally over stdio, so it can be plugged straight into Claude Desktop, Cowork, or any other MCP client config.
What it covers
56 tools spanning: students (create/update/delete/notes & tasks),
staff assignments, applications, CRM leads & consultations, loans
(applications and product catalogue), scholarship applications, users &
roles, management hierarchy, student-deletion approvals, referral codes,
and the analytics/reporting endpoint. A generic admin_api_request
fallback tool covers anything not wrapped by a dedicated tool, so new
backend endpoints remain reachable without a server update.
Related MCP server: mendix-mcp-server
Setup
pip install -r requirements.txt
cp .env.example .env # then fill in your valuesRequired environment variables (see .env.example):
ORIGO_API_BASE_URL— yourorigo_backenddeployment URL, e.g. the Render service URL (no trailing slash).Either
ORIGO_ADMIN_EMAIL+ORIGO_ADMIN_PASSWORD(recommended — the server logs in and auto-refreshes on expiry), or a pre-issuedORIGO_ADMIN_TOKEN.
The account you authenticate with determines what the agent can see and
do: an admin account has unrestricted access; cluster_manager,
manager, and staff accounts are scoped to their reporting hierarchy,
same as when they log into the dashboard directly.
Run directly:
python origo_mcp_server.pyConnecting it to Claude Desktop / Cowork
Add to your MCP client's server config (e.g. claude_desktop_config.json):
{
"mcpServers": {
"origo-admin": {
"command": "python",
"args": ["/absolute/path/to/origo_mcp_server.py"],
"env": {
"ORIGO_API_BASE_URL": "https://your-backend.onrender.com",
"ORIGO_ADMIN_EMAIL": "you@origoabroad.com",
"ORIGO_ADMIN_PASSWORD": "your-password"
}
}
}
}Safety notes
delete_student,delete_user, andapprove_deletion_requestare irreversible. The tool descriptions flag this so agents confirm intent before calling them, but there is no server-side undo.The server only ever holds one bearer token in memory (not persisted to disk); credentials live in your environment/config, not in this repo.
Every action is subject to the same role-based access control as the dashboard itself — the MCP server does not bypass
origo_backend's permission checks, it just calls the same API a logged-in staff member would.
Extending it
Each tool is a thin wrapper: a Python function decorated with @mcp.tool()
that calls _call(method, path, params=..., json_body=...). To add
coverage for a new backend endpoint, either add a small dedicated wrapper
next to the related tools, or just call it via admin_api_request until
you do.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
214 tools for AI agents over one MCP endpoint: image, video, audio, 3D, data, storage, mail, GPUs.
Connect any AI agent to 1,000+ apps and 27,000+ actions through one remote MCP server (OAuth).
Build and run AI workflows, agents, data tables and 1000+ API integrations from any MCP client.
Free public MCP for AI agents — 193 tools, 44 workflows. No API key.
Related MCP Servers
- AlicenseNot gradedqualityBmaintenanceEnables AI agents to administrate WHMCS installations through the External API, providing ~50 tools for clients, billing, orders, services, domains, support, and aggregators with safety features and governance.3ISC
- AlicenseNot gradedqualityDmaintenanceEnables AI agents to read and modify Mendix application models through MCP tools for creating modules, entities, pages, microflows, deploying, and querying runtime data.1ISC
- AlicenseNot gradedqualityCmaintenanceExposes 20 deterministic tools for finance, data, content, and lifestyle tasks via MCP, A2A, and REST interfaces, enabling automation and multi-agent workflows.MIT
- AlicenseNot gradedqualityBmaintenanceEnables AI agents such as ChatGPT, Claude, and local LLMs to operate an enterprise digital-operations platform through MCP, exposing 19 model tools and 3 app-only tools for identity, data, workflow, files, and PII-controlled operations with role-based permissions and two-phase confirmations.Apache 2.0