What are the requirements for mcp4odata?

mcp4odata requires the following environment variables: VCAP_SERVICES (required), S4_DESTINATION_NAME (required), PORT (optional). You'll also need a compatible MCP client like Claude Desktop or Claude Code.

Is mcp4odata free to use?

Yes, mcp4odata is open source and free to use. You can find the source code on GitHub.

What MCP clients support mcp4odata?

mcp4odata works with any MCP-compatible client including Claude Desktop (Anthropic's official desktop app), Claude Code (CLI tool), Cursor, and other editors with MCP support.

How do I configure mcp4odata?

Configure mcp4odata by adding it to your MCP client's config file. The setup block at the top of this page generates a ready-to-paste config for Claude Code, Cursor, Codex, Windsurf, and Claude Desktop.

MCP server/cloud

mcp4odata MCP Server

Q: What tools does mcp4odata provide?

salesorder_get_list: Retrieves a list of S/4HANA sales order headers.. salesorder_create: Creates a new S/4HANA sales order with one or more line items..

Q: How do I install mcp4odata?

Install mcp4odata by running: npm install && npm run build

Exposes SAP S/4HANA OData services as tools for LLMs

horsemanjackyliu/mcp4odata ↗by horsemanjackyliuupdated Apr 9, 2026

Manual setup required. The maintainer's config contains paths only you know - edit the placeholders below before adding it to Claude Code.

Prepare the server locally

Run this once before adding it to Claude Code.

npm install
npm run build

Register it in Claude Code

claude mcp add -e "VCAP_SERVICES=${VCAP_SERVICES}" -e "S4_DESTINATION_NAME=${S4_DESTINATION_NAME}" mcp4odata -- node /path/to/mcp4odata/dist/server.js

Replace any placeholder paths in the command with the real path on your machine.

Required:VCAP_SERVICESS4_DESTINATION_NAME+ 1 optional

Make your agent remember this setup

mcp4odata's config, env vars, and the gotchas you hit — recalled in every future Claude Code, Cursor, and Codex session.

npx conare@latest

Free · one command · indexes the sessions already on disk. Set up in the browser instead →

What it does

Exposes SAP S/4HANA OData v4 services as LLM tools
Supports secure inbound authentication via XSUAA Bearer tokens
Integrates with SAP BTP Destination Service using SAP Cloud SDK
Supports both Streamable HTTP and SSE MCP transports
Enables deep-insert POST operations for sales order creation

Tools 2

salesorder_get_listRetrieves a list of S/4HANA sales order headers.

salesorder_createCreates a new S/4HANA sales order with one or more line items.

Environment Variables

VCAP_SERVICESrequiredJSON string containing XSUAA and Destination service credentials

S4_DESTINATION_NAMErequiredThe name of the BTP destination configured for S/4HANA

PORTPort for the server to listen on

Try it

→List the last 10 sales orders for customer 10100001.

→Create a new sales order for customer 10100001 with 5 units of material MZ-FG-M500.

→Find all sales orders in sales organization 1710.

→Create a sales order for customer 10100001 for 10 units of MZ-FG-M500 with a requested delivery date of 2025-12-31.

Original README from horsemanjackyliu/mcp4odata

mcp4odata

An MCP (Model Context Protocol) server that exposes SAP S/4HANA OData services as tools for LLMs. Deployed on SAP Cloud Foundry (BTP).

Overview

LLM / MCP Client
      │  Bearer token (XSUAA)
      ▼
mcp4odata  (CF app)
      │  SAP Cloud SDK → BTP Destination Service
      ▼
SAP S/4HANA  (CE_SALESORDER_0001, OData v4)

Inbound auth: XSUAA Bearer token validation via @sap/xssec
Outbound connectivity: SAP Cloud SDK executeHttpRequest() with BTP Destination Service
Two MCP transports: Streamable HTTP (MCP 2025-11-25) and SSE fallback (MCP 2024-11-05)

Tools

`salesorder_get_list`

Retrieves a list of S/4HANA sales order headers.

Parameter	Type	Required	Description
`soldToParty`	string	No	Filter by customer number, e.g. `10100001`
`salesOrganization`	string	No	Filter by sales org, e.g. `1710`
`top`	integer	No	Max results, 1–100 (default: 20)

Returns: array of sales order headers — order number, type, sold-to party, total net amount, currency, requested delivery date.

`salesorder_create`

Creates a new S/4HANA sales order with one or more line items (deep-insert POST).

Header fields

Parameter	Type	Required	Description
`salesOrderType`	string	Yes	Order type, e.g. `OR`
`salesOrganization`	string	Yes	Sales org, e.g. `1710`
`distributionChannel`	string	Yes	Distribution channel, e.g. `10`
`organizationDivision`	string	Yes	Division, e.g. `00`
`soldToParty`	string	Yes	Customer number, e.g. `10100001`
`transactionCurrency`	string	No	ISO currency, e.g. `USD` (defaults from customer master)
`purchaseOrderByCustomer`	string	No	Customer PO number
`requestedDeliveryDate`	string	No	Delivery date, `YYYY-MM-DD`

Item fields (at least one item required)

Parameter	Type	Required	Description
`material`	string	Yes	Product number, e.g. `MZ-FG-M500`
`requestedQuantity`	string	Yes	Quantity as a string, e.g. `5`
`requestedQuantitySAPUnit`	string	Yes	SAP unit of measure, e.g. `EA`, `KG`
`plant`	string	No	Delivering plant, e.g. `1710`
`salesOrderItemCategory`	string	No	Item category, e.g. `TAN` (derived from config if omitted)
`salesOrderItemText`	string	No	Line item description (defaults to material description)

Returns: created sales order header including the generated order number.

Endpoints

Endpoint	Auth	Description
`POST/GET/DELETE /mcp`	Bearer (XSUAA)	Streamable HTTP transport — MCP 2025-11-25
`GET /sse`	Bearer (XSUAA)	SSE transport — MCP 2024-11-05
`POST /messages`	Bearer (XSUAA)	SSE message posting
`GET /health`	None	Health check (used by CF)

Local Development

Prerequisites

Node.js 20+
SAP BTP subaccount with XSUAA and Destination service instances

Setup

npm install
cp .env.example .env
# Fill in VCAP_SERVICES with your XSUAA and Destination credentials

.env structure (see .env.example for the full template):

VCAP_SERVICES='{ "xsuaa": [...], "destination": [...] }'
S4_DESTINATION_NAME=S4HANA_SALESORDER
PORT=3000

Run

npm run dev        # tsx watch mode
npm run build      # compile TypeScript → dist/

Test with MCP Inspector

Point the inspector at http://localhost:3000/mcp with a valid XSUAA Bearer token.

BTP Destination Configuration

Create an HTTP destination in the BTP cockpit with:

Field	Value
Name	`S4HANA_SALESORDER` (or your `S4_DESTINATION_NAME`)
Type	HTTP
URL	Your S/4HANA base URL
Authentication	OAuth2ClientCredentials
Token Service URL	XSUAA token endpoint for S/4HANA

The SAP Cloud SDK reads the Destination service binding from VCAP_SERVICES, fetches the destination, and injects the Authorization header automatically.

Cloud Foundry Deployment

Prerequisites

brew install cloudfoundry/tap/cf-cli@8
cf login -a https://api.cf.<region>.hana.ondemand.com
cf target -o <org> -s <space>

Create required service instances

cf create-service xsuaa application xsuaa-mcp4odata -c xsuaa-config.json
cf create-service destination lite destination-mcp4odata

Deploy

npm run build
cf push
cf logs mcp4odata --recent

Useful CF commands

cf env mcp4odata                          # inspect bound service credentials
cf set-env mcp4odata S4_DESTINATION_NAME  # override env variable
cf restage mcp4odata                      # restage after env changes

Project Structure

src/
├── server.ts           # Express app, MCP transports, route setup
├── auth/
│   └── middleware.ts   # XsuaaTokenVerifier — inbound Bearer token validation
├── odata/
│   └── client.ts       # getSalesOrders(), createSalesOrder() via SAP Cloud SDK
└── tools/
    ├── get-sale

Frequently Asked Questions

What are the key features of mcp4odata?

Exposes SAP S/4HANA OData v4 services as LLM tools. Supports secure inbound authentication via XSUAA Bearer tokens. Integrates with SAP BTP Destination Service using SAP Cloud SDK. Supports both Streamable HTTP and SSE MCP transports. Enables deep-insert POST operations for sales order creation.

What can I use mcp4odata for?

Automating sales order entry via natural language interfaces. Querying enterprise sales data directly from LLM-powered assistants. Integrating SAP S/4HANA workflows into AI-driven business processes. Simplifying SAP data access for non-technical business users.

How do I install mcp4odata?

Install mcp4odata by running: npm install && npm run build

What MCP clients work with mcp4odata?

mcp4odata works with any MCP-compatible client including Claude Desktop, Claude Code, Cursor, and other editors with MCP support.

Conare · memory for coding agents

Turn this server into reusable context

Keep mcp4odata docs, env vars, and workflow notes in Conare so your agent carries them across sessions.

Set up free$npx conare@latest

Prepare the server locally

Register it in Claude Code

Make your agent remember this setup

What it does

Tools 2

Environment Variables

Try it

mcp4odata

Overview

Tools

`salesorder_get_list`

`salesorder_create`

Endpoints

Local Development

Prerequisites

Setup

Run

Test with MCP Inspector

BTP Destination Configuration

Cloud Foundry Deployment

Prerequisites

Create required service instances

Deploy

Useful CF commands

Project Structure

Frequently Asked Questions

Turn this server into reusable context

Related MCP Servers