MCP Server for ERPNext REST API
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"erpnext-mcp","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# ERPNext MCP Server MCP (Model Context Protocol) server for ERPNext REST API, built with [FastMCP](https://github.com/jlowin/fastmcp) and Python. ## Features - **CRUD** — List, get, create, update, delete documents - **Workflow** — Submit and cancel submittable documents - **Reports** — Run ERPNext query reports - **Schema** — Inspect DocType field definitions, list all DocTypes - **Inventory** — Stock balance, stock ledger, item prices - **Trading** — Document conversion (e.g. Quotation → Sales Order), party balance - **Supplier/Customer** — Get complete details with address, phone, contacts; supports alias search - **Files** — Upload, list, download files - **Helpers** — Link search (autocomplete), document count, generic method calls ## Requirements - Python >= 3.11 - [uv](https://docs.astral.sh/uv/) (recommended) or pip - ERPNext instance with API key/secret ## Setup ```bash # Clone the repo git clone <repo-url> && cd erpnext-mcp # Create .env file cat > .env << 'EOF' ERPNEXT_URL=https://your-erpnext-instance.com ERPNEXT_API_KEY=your_api_key ERPNEXT_API_SECRET=your_api_secret EOF # Install dependencies uv sync ``` ## Run ```bash set -a && source .env && set +a && uv run erpnext-mcp ``` ## Available Tools | Tool | Description | |---|---| | `list_documents` | List documents with filters, sorting, pagination | | `get_document` | Get a single document by name | | `create_document` | Create a new document | | `update_document` | Update an existing document | | `delete_document` | Delete a document | | `submit_document` | Submit a submittable document | | `cancel_document` | Cancel a submitted document | | `run_report` | Execute an ERPNext report | | `get_count` | Get document count with optional filters | | `get_list_with_summary` | List documents with total count | | `run_method` | Call any whitelisted server-side method | | `search_link` | Link field autocomplete search | | `list_doctypes` | List all available DocType names | | `get_doctype_meta` | G…
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.