erpnext-agent¶
ERPNext and Frappe REST/RPC API + MCP Server for the scion-sdk ecosystem — a typed, deterministic tool surface over the ERPNext / Frappe business platform.
Official documentation
This site is the canonical reference for erpnext-agent, maintained alongside
every release.
Overview¶
erpnext-agent wraps the ERPNext / Frappe Framework REST and whitelisted-RPC
surface with typed, deterministic MCP tools, and ships an optional Pydantic-AI
Api— a tolerantrequests-based REST/RPC facade over the Frappe site (token or username/password authentication, configurable TLS verification).- Document and method tools — read, create, update, delete, and list any
ERPNext DocType, plus
call_methodto invoke any whitelisted RPC endpoint (covering custom server functions). (erpnext-agent) that calls those tools through a policy router.
The connector remains inactive when credentials are absent, so it is safe to load in any environment.
Explore the documentation¶
- :material-rocket-start: Installation — pip, source, extras, and the prebuilt Docker image.
- Usage — the MCP tools, the
Apiclient, and example prompts. - Backing Platform — deploy ERPNext / Frappe with Docker.
- Overview — the dynamic facade and FastMCP tool layer.
- Concepts — the
CONCEPT:ERPN-*registry.
Quick start¶
Connect it to an ERPNext / Frappe site:
export ERPNEXT_URL=<configured-endpoint>
export ERPNEXT_TOKEN=<runtime-secret>
erpnext-mcp --transport streamable-http --host 0.0.0.0 --port 8000
See Installation and Deployment for the full matrix (PyPI extras, Docker image, all transports, reverse proxy, DNS).
Spec delivery¶
Spec delivery dashboard. No owned specs are recorded yet. Missing requirement and code mappings remain unknown.