Skip to content

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.

PyPI MCP Server License GitHub

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 tolerant requests-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_method to 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 Api client, 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

pip install "erpnext-agent[mcp]"
erpnext-mcp                       # stdio MCP server (default transport)

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.