SAP S/4HANA MCP ERP

Read sales orders, business partners, purchase orders and any OData V2 service from SAP S/4HANA.

2 credits / tool call

Quick start

Add a SAP S/4HANA connection with the settings below, then click Test configuration.
Create an API key for your agent.
Paste the key below, click Test endpoint, and copy the configuration for your platform.

Endpoint	`https://market.oshaani.com/sap` (your default connection) or `https://market.oshaani.com/sap/<connection-id>`
Transport	Streamable HTTP (stateless, JSON responses). MCP protocol versions 2024-11-05 to 2025-11-25 and 2026-07-28.
Authentication	`Authorization: Bearer <API key>`, using a key from the API keys page.

Agent configuration

Endpoint The default URL uses your organisation's default SAP S/4HANA connection; a URL with an ID pins one connection.

API key

Get a key

The key is filled into the snippets below. It stays in this page and is only sent with the test request.

Runs initialize and tools/list against the endpoint, exactly like an agent. No credits are charged.

Any MCP client that supports remote (Streamable HTTP) servers with custom headers.

{
  "name": "sap",
  "transport": "streamable-http",
  "url": "https://market.oshaani.com/sap",
  "headers": {
    "Authorization": "Bearer YOUR_API_KEY"
  }
}

~/.cursor/mcp.json (all projects) or .cursor/mcp.json in a project.

{
  "mcpServers": {
    "sap": {
      "url": "https://market.oshaani.com/sap",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Settings > Developer > Edit Config (claude_desktop_config.json). Uses the mcp-remote bridge; needs Node.js.

{
  "mcpServers": {
    "sap": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://market.oshaani.com/sap",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Run in your terminal, or put the JSON in .mcp.json at the project root.

claude mcp add --transport http sap https://market.oshaani.com/sap \
  --header "Authorization: Bearer YOUR_API_KEY"

# .mcp.json
{
  "mcpServers": {
    "sap": {
      "type": "http",
      "url": "https://market.oshaani.com/sap",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

.vscode/mcp.json (GitHub Copilot agent mode). VS Code prompts for the key once and stores it securely.

{
  "inputs": [
    {
      "type": "promptString",
      "id": "oshaani-mcp-key",
      "description": "oshaani MCP Marketplace API key",
      "password": true
    }
  ],
  "servers": {
    "sap": {
      "type": "http",
      "url": "https://market.oshaani.com/sap",
      "headers": {
        "Authorization": "Bearer ${input:oshaani-mcp-key}"
      }
    }
  }
}

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "sap": {
      "serverUrl": "https://market.oshaani.com/sap",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Responses API remote MCP tool (Python SDK).

from openai import OpenAI

client = OpenAI()
response = client.responses.create(
    model="gpt-4.1",
    tools=[{
        "type": "mcp",
        "server_label": "sap",
        "server_url": "https://market.oshaani.com/sap",
        "headers": {"Authorization": "Bearer YOUR_API_KEY"},
        "require_approval": "never",  # or "always" to approve each tool call
    }],
    input="What can you do with these tools?",
)
print(response.output_text)

Messages API MCP connector (Python SDK).

import anthropic

client = anthropic.Anthropic()
response = client.beta.messages.create(
    model="claude-sonnet-4-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "What can you do with these tools?"}],
    mcp_servers=[{
        "type": "url",
        "url": "https://market.oshaani.com/sap",
        "name": "sap",
        "authorization_token": "YOUR_API_KEY",
    }],
    betas=["mcp-client-2025-04-04"],
)
print(response.content)

Official MCP Python SDK 2.x (pip install mcp); works inside any agent framework.

import asyncio

from mcp import ClientSession
from mcp.client.streamable_http import create_mcp_http_client, streamable_http_client


async def main():
    headers = {"Authorization": "Bearer YOUR_API_KEY"}
    async with create_mcp_http_client(headers=headers) as http:
        async with streamable_http_client("https://market.oshaani.com/sap", http_client=http) as (read, write, *_):
            async with ClientSession(read, write) as session:
                await session.initialize()
                tools = await session.list_tools()
                print([tool.name for tool in tools.tools])


asyncio.run(main())

Quick check from a terminal: lists the tools without charging credits.

curl -s https://market.oshaani.com/sap \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "MCP-Protocol-Version: 2025-06-18" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Connection settings

Entered once per connection on market.oshaani.com. Secrets are encrypted and never shown again or sent to agents.

Setting	Type	Description
SAP system URL `url` required	string (uri)	Base URL of the S/4HANA (or Gateway) system, e.g. https://my123456-api.s4hana.cloud.sap min length 1, max length 2083
User `username` required	string	Communication user (S/4HANA Cloud) or technical user with display authorizations
Password `password` required secret	string
SAP client `sap_client`	string	e.g. 100; leave empty for the default client pattern ^\d{3}$
Verify TLS certificate `verify_tls`	boolean default true

Tools (7)

`list_services` read-only

Find OData services in the SAP Gateway catalog

Argument	Type	Description
`search`	string	Part of the technical service name, e.g. SALES max length 60
`top`	integer default 100	Maximum number of records min 1, max 500

`get_service_metadata` read-only

List a service's entity sets with their keys, fields and navigation properties

Argument	Type	Description
`service` required	string	OData service, e.g. API_SALES_ORDER_SRV max length 120, pattern ^[A-Za-z0-9_/]+(;v=\d{1,4})?$
`entity_set`	string	Only describe this entity set

`query_entity_set` read-only

Query any OData entity set with $filter, $select, $orderby and $expand

Argument	Type	Description
`service` required	string	OData service, e.g. API_SALES_ORDER_SRV max length 120, pattern ^[A-Za-z0-9_/]+(;v=\d{1,4})?$
`entity_set` required	string	Entity set, e.g. A_SalesOrder pattern ^[A-Za-z_][A-Za-z0-9_]{0,127}$
`filter`	string	OData V2 filter, e.g. "CreationDate ge datetime'2026-01-01T00:00:00'" max length 2000
`select`	array of string	Fields to return
`orderby`	string	e.g. 'CreationDate desc' max length 200
`expand`	array of string	Navigation properties to include, e.g. ['to_Item']
`top`	integer default 50	Maximum number of records min 1, max 500
`skip`	integer default 0	min 0

`get_entity` read-only

Get a single entity by its key

Argument	Type	Description
`service` required	string	OData service, e.g. API_SALES_ORDER_SRV max length 120, pattern ^[A-Za-z0-9_/]+(;v=\d{1,4})?$
`entity_set` required	string	Entity set, e.g. A_SalesOrder pattern ^[A-Za-z_][A-Za-z0-9_]{0,127}$
`key` required	string	OData key, e.g. '4711' or SalesOrder='4711',SalesOrderItem='10' max length 500, pattern ^[^/?#]+$
`expand`	array of string

`read_sales_orders` read-only

Read sales orders, newest first, optionally for a customer or from a date

Argument	Type	Description
`sold_to_party`	string	Customer number max length 10
`created_from`	string (date)
`include_items`	boolean default false
`top`	integer default 50	Maximum number of records min 1, max 500

`read_business_partners` read-only

Search business partners (customers and suppliers) by name or number

Argument	Type	Description
`search`	string	Part of the name, or the partner number max length 80
`top`	integer default 50	Maximum number of records min 1, max 500

`read_purchase_orders` read-only

Read purchase orders, newest first, optionally for a supplier

Argument	Type	Description
`supplier`	string	Supplier number max length 10
`top`	integer default 50	Maximum number of records min 1, max 500

Billing & errors

Each successful tool call costs 2 oshaani.com credits. initialize, tools/list, failed calls and timeouts are free.

JSON-RPC code	Meaning
`-32054` (HTTP 401)	Missing, unknown or revoked API key
`-32053` (HTTP 404)	No SAP S/4HANA connection configured for your organisation, or the connection ID is wrong
`-32055` (HTTP 403)	Connection disabled or origin not allowed
`-32052` (HTTP 429)	Rate limit reached; retry after a minute
`-32050`	Not enough oshaani.com credits for the call
`-32051`	Billing temporarily unavailable; the call was not run

Errors from SAP S/4HANA itself (bad IDs, permissions) come back as tool results with isError: true so the agent can read and correct them. See the SAP S/4HANA API documentation.

SAP S/4HANA MCP ERP

Quick start

Agent configuration

Connection settings

Tools (7)

list_services read-only

get_service_metadata read-only

query_entity_set read-only

get_entity read-only

read_sales_orders read-only

read_business_partners read-only

read_purchase_orders read-only