Skip to content

Latest commit

 

History

History
288 lines (204 loc) · 24.1 KB

File metadata and controls

288 lines (204 loc) · 24.1 KB

AnythingMCP turns ERP, e-commerce, REST, SOAP and SQL systems into MCP tools for Claude and ChatGPT: 265 connectors, 21 of them with no API key.

AnythingMCP: self-hosted MCP gateway

English · Deutsch · 简体中文 · 日本語

AnythingMCP is an open-source, self-hosted MCP gateway that turns any REST/OpenAPI, SOAP, GraphQL, OData or SQL system into MCP tools for Claude, ChatGPT and Copilot, without writing an MCP server.
It ships 265 ready connectors, among them SAP, Odoo, Xentral, weclapp, Shopware, WooCommerce and Amazon Seller, and 21 of them need no API key.

GitHub Stars Release Open source, AGPL-3.0 Docker pulls

Try the Cloud free for 7 days · Run it yourself · Docs · Connector guides · Discussions

One question in Claude, answered from Etsy, SAP and a logistics API. The demo installs Etsy from the catalog, adds SAP S/4HANA over OData and imports a logistics API from its OpenAPI spec, then Claude works across all three (2:40, with sound):

AnythingMCP-demo-Etsy-SAP-logistics.mp4

In production at KOCH Freiburg GmbH, where it connects AI assistants to 15+ internal systems: ERP, CRM, SOAP services and on-prem databases. helpcode.ai extracted it from that system and open-sourced it, because an adapter catalog grows faster as a community than as a product.


Run it yourself

Requires Docker 24+ and openssl; on macOS, start Docker Desktop first. No clone needed:

mkdir anythingmcp && cd anythingmcp
curl -fsSLo docker-compose.yml \
  https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Open http://localhost:3000 and register: the first account becomes admin. Your MCP endpoint is http://localhost:4000/mcp, the API docs are at http://localhost:4000/api/docs.

Keep the generated .env. ENCRYPTION_KEY decrypts the credentials you store. Lose it and every connector has to be re-credentialed.

On amd64 the image pulls in about 30 s and the API is healthy 24 s later. The image is amd64 only for now; the compose file pins the platform, so it also runs on Apple Silicon under emulation.

The quickstart binds to 127.0.0.1 on purpose, because nothing in front of it terminates TLS. For an instance other people or a cloud AI client can reach, clone the repo and run ./setup.sh: it asks for a domain, gets certificates through Caddy, generates the secrets and sets the MCP auth mode. See the Deployment Guide.

Other ways to run it: managed cloud, Railway, DigitalOcean

AnythingMCP Cloud is the same AGPL code, operated by us in Frankfurt, Germany, with a 7-day free trial. Start there to try it on your own APIs, and move it in-house when you want the credentials to stop travelling; the connectors are the same either way. DPA/AVV on request via info@helpcode.ai. SSO and SCIM are self-hosted only.

Deploy on Railway   Install on DigitalOcean


How it works

  1. Add a connector. Install an adapter from the catalog (a ready JSON definition for SAP, Odoo, DHL and the rest), or point AnythingMCP at your own OpenAPI spec, WSDL, GraphQL endpoint, Postman collection or database. Once configured in your workspace it is a connector, and each of its operations is an MCP tool.
  2. Decide what the model sees. Rename and describe the tools in the visual editor, drop the fields that must not leave your network, and choose which roles may call which tools.
  3. Hand one URL to your AI client. An MCP server is the endpoint you add to Claude, ChatGPT, Copilot, Gemini or Cursor. It exposes the connectors you assign to it, and nothing else.

Connect any API, SOAP service or database

Most companies have no MCP servers yet. They have a REST API, an ERP, a SOAP service from 2009 and a database. Each of them becomes a set of MCP tools:

Source What you get Docs
OpenAPI / Swagger (REST) Import a spec by URL or paste it; every operation becomes a tool with parameters, auth and endpoint mapping filled in REST · guide · demo: openapi-to-mcp
Postman collection, cURL Folders, auth, body modes and {{variables}} carry over; every request becomes a tool Postman import
SOAP / WSDL Each operation becomes a tool; envelopes, parameter order and WCF services are handled for you SOAP · guide · demo: soap-to-mcp
GraphQL Introspection turns queries and mutations into tools, or you define the operations yourself GraphQL · guide
OData (SAP Gateway included) Reads each service's $metadata, so the model sees entity sets, keys and SAP's business labels; V2 and V4 OData · guide
SQL and MongoDB PostgreSQL, MySQL, MariaDB, SQL Server, Oracle, SAP HANA, SQLite and MongoDB: schema, example and query tools, read-only by default Database · SAP HANA · guide · demo: sql-to-mcp
Another MCP server Discover its tools and serve them next to your own, behind the same auth and audit MCP bridge

Tools register at runtime, without a restart. Per-connector {{VAR}} values are interpolated on the server and never shown to the AI.


Connector catalog

265 adapters, exposing 2,400+ tools. Every one has a setup guide on anythingmcp.com/guides, in seven languages.

Category Examples
💼 ERP, accounting & invoicing SAP Business One, SAP S/4HANA, Odoo, weclapp, Xentral, Dynamics NAV, Lexware Office, sevDesk, Exact Online, bexio
🛍️ E-commerce & marketplaces Amazon Seller, WooCommerce, Shopware 6, Magento, eBay, Etsy, Kaufland, OTTO, Oxomi
📦 Logistics & shipping Deutsche Bahn, DHL, DPD, GLS, Shipcloud, Sendcloud
👥 HR & field service Personio, HRWorks, Kenjo, MFR Mobile Field Report
🏛️ Government & public data VIES VAT, Handelsregister, UK Companies House, DESTATIS, Bundesbank, OpenPLZ, NINA
🏦 Banking & payments Revolut Business, Wise, PAYONE, Razorpay, Paystack
💬 Messaging WhatsApp, LINE, TeamViewer
📈 Advertising & analytics Google Ads, Google Analytics 4, Google Search Console, Matomo
🧠 AI decision models Jev by TypeSafe: yes/no, classification and scoring with probabilities, in about 300 ms

ERP connectors: 18 systems, with tools and markets
System Market Tools What the AI can do
SAP Business One Global 12 Business partners, items, orders, invoices, quotations, deliveries; create sales orders
SAP S/4HANA Cloud Global 15 Business partners, sales and purchase orders, billing documents, deliveries, journal entries
SAP S/4HANA (HANA SQL) Global 10 S/4HANA on-premise and Private Cloud read straight from HANA, with SAP's data dictionary and CDS views as tools; read-only
SAP S/4HANA (OData) † Global 7 Gateway OData services with SAP's labels: journal entry items, billing documents, sales orders, business partners, stock, products
Odoo Global 11 Any model: partners, sales orders, invoices, products; create and update
Microsoft Dynamics NAV Global 6 Any published OData page: customers, items, sales orders; create and update
ERPNext Global 11 Any DocType: customers, sales orders, invoices, items, stock
Dolibarr Global 10 Third parties, invoices, orders, proposals, products, stock
JTL-Wawi † DE 9 Items, stock per warehouse, customers, sales orders, shipments
Xentral DE 7 Articles, customers, sales orders, invoices, stock
weclapp DACH 11 Customers, sales orders, invoices, articles, quotations, opportunities
Sage 100 † DE 6 Addresses, items, sales documents, any Web API entity
Haufe X360 † DE 7 Customers, stock items, sales orders, invoices, shipments
ScopeVisio DE 6 Contacts, invoices, projects, tasks
AFAS Profit † NL 6 Any GetConnector: debtors, invoices, employees
Zucchetti † IT 6 Anagrafiche, documents, items
TeamSystem † IT 6 Customers, suppliers, invoices, items
Axonaut † FR 9 Companies, invoices, quotations, expenses, products, projects

† Built from the vendor's published API documentation and not yet exercised against a live tenant. If you run one of these, a report or a fix is very welcome.

Repositories: erp-mcp-server · weclapp-mcp-server · odoo-mcp-server · sap-mcp-server · sap-hana-mcp-server · sap-business-one-mcp-server · xentral-mcp-server

E-commerce & marketplace connectors: 13 shops and marketplaces
System Market Tools What the AI can do
Amazon Seller Central Global 15 Orders, catalog, FBA inventory, offers, fees, financial events, reports
WooCommerce Global 49 Products, variations, stock, orders, refunds, customers, reports
Shopware 6 DACH 6 Storefront catalog via the Store API: products, categories, cross-sells
Magento 2 / Adobe Commerce Global 12 Products, stock, orders, customers
BigCommerce Global 14 Products, variants, inventory, orders, customers
eBay Sell Global 10 Inventory, offers, orders, disputes, price updates
Etsy Global 9 Listings, receipts (orders), reviews
Ecwid Global 10 Products, categories, orders, customers
Kaufland Marketplace DE 8 Orders and units, shipments, tickets, storefronts
OTTO Market † DE 8 Orders, products, returns, stock and price updates
Zalando Direct Ship † EU 7 Orders, shipments, returns, stock, prices
Billbee DACH 8 Orders, products, customers, shipping providers
Mercado Libre LATAM 4 Item search, seller orders

† Built from the vendor's published API documentation and not yet exercised against a live seller account.

Repositories: ecommerce-mcp-server · amazon-seller-mcp-server · billbee-mcp-server · magento-mcp-server · woocommerce-mcp-server · shopware-mcp-server · kaufland-mcp-server · otto-market-mcp-server

An adapter is a single JSON file. That is why the catalog is this size, and why adding one is a reasonable first contribution. Missing yours? Request it (we prioritise by 👍) or build it. Your ERP isn't listed, or it's a custom build? Connect its REST API, its SOAP services or its SQL database directly, read-only.


Security and governance

Everything runs on your infrastructure, so you decide what leaves it. OAuth2, RBAC, SSO and SCIM are in the self-hosted build, not held back for a paid tier.

  • Response mapping. Each tool declares exactly which fields reach the model: drop a customer's IBAN or an employee's salary, or name the fields to keep. The editor shows the before/after on a real response; a shipped adapter goes from 12,172 B to 1,072 B (−91%), so you also stop paying for those fields in the context window. A broken mapping returns the raw response by default; set "fallbackToRaw": false on tools whose fields must never travel, and the call fails instead.
  • Read-only where it matters. Every tool carries MCP annotations (readOnlyHint, destructiveHint), derived from the operation and overridable per tool. Role-based tool whitelisting lets you publish an MCP server that can only read, which is how most people should start with an ERP. Database query tools run a single SELECT and block writes and stacked statements.
  • Every auth scheme you will meet. OAuth2 (PKCE and Client Credentials), Bearer, API key, Basic, HMAC request signing, LOGIN_TOKEN and OAuth 1.0a. Credentials are encrypted at rest with AES-256-GCM.
  • Audit log. Every tool call is recorded with input, output, duration and status in your own database, including the full upstream response the model never saw.
  • SSO and SCIM. Entra ID, Google, Okta, Auth0 or any OIDC provider. Roles sync from your directory groups on every sign-in; disable someone in the directory and their workspace access and MCP API keys go with it.
{
  "transform": {
    "mode": "select",
    "fallbackToRaw": false,
    "exclude": ["customer.iban", "customer.taxId"],
    "select": { "order": "$.id", "total": "$.amounts.gross", "status": "$.state" }
  }
}

Response mapping reference


Use it from Claude, ChatGPT, Copilot and Gemini

The same MCP server works in every client that speaks MCP, so you build a connector once:

  • Claude. Add the server URL as a custom connector under Customize → Connectors; it then works in Claude.ai, Claude Desktop and Claude Code. OAuth 2.0 is supported out of the box. Claude setup
  • ChatGPT. Apps in ChatGPT are built on MCP. Add the server in ChatGPT's settings, or use it as the tool layer of an Apps SDK app. ChatGPT setup
  • Copilot, Gemini, Cursor and other MCP clients: client setup guides.

Knowledge Graph and AI skills

Forwarding calls leaves the hard part to the agent: knowing which tool to call next, and what your business means by "open order". AnythingMCP learns both and hands them back as context, not as extra tool calls.

  • Knowledge Graph. A per-workspace map of entities (customers, orders, products) and how they relate across connectors, built from tool definitions and real calls, and editable by hand. It stores field names and relationships, never values. Each server exposes it through a kg_how_to_obtain tool, so the agent can ask how to get from a Shopware order to a DHL tracking number.
  • AI skills. Recurring usage turned into small rules ("today's revenue includes order statuses 2, 3 and 4") that you apply, edit or dismiss, and that are composed into the server's instructions.

The AI passes are off by default and use your own OpenAI, OpenRouter or Anthropic key; the graph, the editor and the MCP tool work without one. Knowledge Graph guide


Where it fits

Most MCP gateways federate and secure MCP servers you already have. AnythingMCP starts one step earlier: it creates the MCP servers from the APIs, ERPs and databases you already run, then serves, scopes and audits them behind one endpoint. If your tools are already MCP servers and all you need is federation, a pure gateway may be enough. Side-by-side comparisons: anythingmcp.com/vs.


FAQ

What is an MCP gateway?

A single MCP endpoint in front of many tools, which handles authentication, access control and audit for all of them. AI clients such as Claude and ChatGPT connect to the gateway instead of to each system. AnythingMCP is a gateway that also generates the tools, from APIs and databases that have no MCP server of their own.

How do I connect my ERP (SAP, Odoo, Xentral…) to Claude or ChatGPT?

Install the ERP's adapter from the catalog, enter the API credentials, and add your MCP server URL to Claude as a custom connector or to ChatGPT as an app. If your ERP has no adapter, connect its REST or SOAP API or its SQL database directly. Start with a role that can only read.

How do I turn an OpenAPI spec into an MCP server?

Create a REST connector and import the spec by URL or by pasting it. Every operation becomes an MCP tool on your server's /mcp endpoint, with no code. How it works

Can I connect a SOAP/WSDL service to Claude?

Yes. AnythingMCP parses the WSDL, turns each operation into a tool and builds the SOAP envelope on every call, WCF services included. It authenticates with HTTP Basic, Bearer or an API-key header; WS-Security headers are not implemented yet. SOAP connector docs

Can Claude query my SQL Server, Oracle or PostgreSQL database safely?

Query tools are read-only by default. On top of that, use a database user with SELECT rights only, prefer static queries where the model supplies just the parameters, and whitelist the tools per role. Response mapping drops the columns that must not reach the model, and every query lands in your audit log.

How do I connect Shopware, WooCommerce or Amazon Seller Central to Claude?

Install the e-commerce adapter for your shop or marketplace and authorise it. WooCommerce comes with 49 tools, Amazon Seller Central uses the official Selling Partner API, and the Shopware 6 adapter reads the storefront catalog through the Store API.

Is AnythingMCP free, and can I self-host it?

Yes. It runs on your own servers under AGPL-3.0, commercial use included. AnythingMCP Cloud is the optional hosted version, operated in Frankfurt, with a 7-day free trial.


Community and support

Contributing

Read the Contributing guide before opening a PR. The easiest useful contribution is an adapter: one JSON file, and there is a walkthrough issue for it.

License

Open source under the GNU Affero General Public License v3 (AGPL-3.0-only). Commercial use inside your own company is included and always was; the copyleft obligation only starts if you modify AnythingMCP and offer the modified version to others over a network. Cloud-operator code under ee/ is separately licensed and is not required for self-hosting; see the License FAQ.


⭐ If this saved you a week of writing MCP servers, star it.
Stars are how the next person finds it, and how we decide which adapter to build next.

Star history

Contributors