MCP serverMCP servertypeExposes tools to a coding agent over MCP.See every one →What this type is →independently maintainedindependently maintainedoriginPublished by one person or a small company outside SAP. Says nothing about quality; the readings say that.See every one →

mcp-sap-cpi

The runtime half of Cloud Integration: failed messages with their full processing logs and traces, artifact deployment, security material, and a health summary.

Written for the morning after. Message monitoring lists failed messages, retrieves full MPL details and pulls trace logs; integration content browses packages and artifacts and deploys or undeploys an iFlow; the security section lists credentials, keystores and OAuth2 configurations; and a runtime section reports deployed artifact status and a system health summary. Diagnosing a failure and redeploying the fix are in one place.

Facts

Last pushLicenceMIT

Where it sits

Lives in
Provides
Agent access to your systemsBTPAgent access to your systemscapabilityGiving an AI agent access to the business data, configuration or operations of systems you run through an MCP server. [Serving your application over MCP](capability:mcp-servers) exposes your own service contract; system access reaches the systems behind it, and one implementation may do both. Development assistance belongs to [agent access to your code](capability:agent-code-access).

Who is behind it

KeelsideKeelsideOrganisationMaintains this
In the atlas: maintains 1
@Keelside
maintainerPrudvi TarigondaPersonContributes to this
In the atlas: contributes to 1
@prudvigit
1 contributor

Before choosing this

Conditions

PracticalFunctional boundary

It deploys and undeploys, and it enumerates credentials, keystores and OAuth2 configurations. Listing security material is a read, and it is still a read of the thing that protects everything else the tenant talks to.

PolicySAP API Policy 4.2026a§ 1.1, 1.2, 2.2.2from Agent access to your systemsAn MCP server uses SAP APIs to supply tools, resources or data to an agent.
  • § 1.1 Published APIs. Published APIs are made available for the documented purposes identified by SAP, including integration, extensions and data exchange.
  • § 1.2 Non-Published APIs. Customer and third-party applications must not access non-published APIs except where documentation permits it or SAP otherwise authorizes it.
  • § 2.2.2 AI call sequences and data extraction. Outside SAP-endorsed architectures, data services or expressly identified pathways, the policy prohibits specified agentic API use and systematic or large-scale extraction.

MCP does not replace the API's documented-use boundary. Check that every endpoint is published for the intended use and whether the policy's AI-call or extraction provisions apply to the design.

SAP API Policy 4.2026a →

What it declares

Every artifact

Type
MCP server
Origin
Independently maintained

As an MCP server

Language
TypeScript

Connections1

README

quoted from Keelside/mcp-sap-cpi under MIT, read
Keelside/mcp-sap-cpi/README.mdOn GitHub

mcp-sap-cpi

An open-source MCP (Model Context Protocol) server that connects Claude to SAP Cloud Platform Integration (CPI). Ask Claude to diagnose failed messages, review iFlows, deploy artifacts, check credentials, and more — directly from your conversation.

What it does

CategoryTools
Message MonitoringList failed messages, get full MPL details, retrieve trace logs
Integration ContentBrowse packages, list artifacts, deploy/undeploy iFlows
Security ArtifactsList credentials, keystores, OAuth2 configurations
Runtime StatusCheck deployed artifact status, system health summary

Requirements

  • Node.js 18+
  • SAP CPI tenant (Integration Suite or standalone CPI)
  • BTP service key with Process Integration Runtime role (it-rt plan)

Installation

npm install -g mcp-sap-cpi

Or run without installing:

npx mcp-sap-cpi

Configuration

1. Get your BTP service key

In SAP BTP Cockpit:

  1. Go to your subaccount → Services → Instances and Subscriptions
  2. Create a service instance: Process Integration Runtime → plan it-rt
  3. Create a service key → copy the JSON

From the service key JSON, extract:

  • url → CPI_TENANT_URL
  • tokenurl → CPI_TOKEN_URL
  • clientid → CPI_CLIENT_ID
  • clientsecret → CPI_CLIENT_SECRET
2. Set environment variables

Create a .env file (or set in your Claude Desktop config — see below):

CPI_TENANT_URL=https://<tenant>.it-cpi.cfapps.<region>.hana.ondemand.com
CPI_TOKEN_URL=https://<subdomain>.authentication.<region>.hana.ondemand.com/oauth/token
CPI_CLIENT_ID=sb-<your-client-id>
CPI_CLIENT_SECRET=<your-client-secret>
3. Register with Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "sap-cpi": {
      "command": "npx",
      "args": ["mcp-sap-cpi"],
      "env": {
        "CPI_TENANT_URL": "https://<tenant>.it-cpi.cfapps.<region>.hana.ondemand.com",
        "CPI_TOKEN_URL": "https://<subdomain>.authentication.<region>.hana.ondemand.com/oauth/token",
        "CPI_CLIENT_ID": "your-client-id",
        "CPI_CLIENT_SECRET": "your-client-secret"
      }
    }
  }
}
4. Register with Claude Code
claude mcp add sap-cpi npx mcp-sap-cpi \
  -e CPI_TENANT_URL=https://<tenant>.it-cpi.cfapps.<region>.hana.ondemand.com \
  -e CPI_TOKEN_URL=https://<subdomain>.authentication.<region>.hana.ondemand.com/oauth/token \
  -e CPI_CLIENT_ID=your-client-id \
  -e CPI_CLIENT_SECRET=your-client-secret

Tools Reference

Message Monitoring
get_failed_messages

List failed messages from the Message Processing Log.

ParameterTypeRequiredDescription
topnumberNoMax results (default: 20)
artifactNamestringNoFilter by iFlow name
fromDatestringNoISO date — messages after this date

Example prompt: "Show me the last 10 failed messages in CPI"


get_message_details

Get full MPL details for a specific message.

ParameterTypeRequiredDescription
messageIdstringYesThe CPI message GUID

Example prompt: "Get details for message ID abc-123-def"


get_trace_log

Get step-by-step payload trace for a message (requires trace mode enabled on the iFlow).

ParameterTypeRequiredDescription
messageIdstringYesThe CPI message GUID

Example prompt: "Show me the trace log for message abc-123-def"


Integration Content
list_packages

List all integration packages in the tenant.

Example prompt: "What integration packages do I have in CPI?"


list_artifacts

List all artifacts in a package.

ParameterTypeRequiredDescription
packageIdstringYesThe integration package ID

Example prompt: "List all iFlows in the HR_Integration package"


get_artifact

Get metadata and configuration for a specific artifact.

ParameterTypeRequiredDescription
artifactIdstringYesThe artifact ID
artifactTypestringYesIntegrationFlow, MessageMapping, ScriptCollection, or ValueMapping

deploy_artifact

Deploy an artifact version to the runtime.

ParameterTypeRequiredDescription
artifactIdstringYesThe artifact ID
artifactTypestringNoDefault: IntegrationFlow

Example prompt: "Deploy the Employee_Sync iFlow"


undeploy_artifact

Undeploy an artifact from the runtime.

ParameterTypeRequiredDescription
artifactIdstringYesThe artifact ID

Security Artifacts
list_credentials

List all user credential (basic auth) aliases.

Example prompt: "What credentials are configured in CPI?"


list_keystores

List all keystore entries with alias and expiry date.

Example prompt: "Are any of my CPI certificates expiring soon?"


list_oauth_credentials

List all OAuth2 client credential configurations.


Runtime Status
get_runtime_artifacts

List all deployed runtime artifacts with status (STARTED, STOPPED, ERROR).

Example prompt: "Which iFlows are currently in ERROR state?"


get_system_status

Get a summary of deployed artifact health.

Example prompt: "Give me a CPI system health check"


Example conversations

Diagnose a failed message:

"Why did my HR_Employee_Sync iFlow fail? Show me the last error."

Check certificates:

"List all keystore entries in CPI and flag any expiring within 90 days."

Deploy after a fix:

"Deploy the Order_Processing iFlow to the runtime."

Audit credentials:

"What OAuth2 credentials are configured in my CPI tenant?"

System overview:

"Give me a health check — how many iFlows are running vs in error?"


Local development

git clone https://github.com/prudvigit/mcp-sap-cpi.git
cd mcp-sap-cpi
npm install
cp .env.example .env
# fill in your CPI credentials in .env
npm run dev

Roadmap

  • Value mapping query tool
  • Alert management tools
  • iFlow content download (for AI-assisted review)
  • Integration with tics-sap-ai-suite

License

MIT

MIT, read
Agent access to your systems
  1. mcp-integration-suiteMCP server for the general Integration Suite functions
  2. mcp-is-tpmJava MCP server for Integration Suite Trading Partner Management
  3. calmcpMCP server with read tools over the SAP Cloud ALM APIs
  4. CostingGeek/sap-mcpPython MCP server fetching sales orders from SAP's business data graph
  5. mcp-sap-focusedrunMCP tools over SAP Focused Run's Landscape Management Database
  6. cloud-alm-itsm-mcpMCP server querying installations via the SAP Cloud ALM ITSM API
  7. hana-mcp-serverMCP server for schema discovery and guarded SQL on SAP HANA
  8. sap_analytics_cloud_mcpMCP server for the SAP Analytics Cloud REST API
  9. AI Core MCP ServerSAP AI Core APIs as MCP tools from one JSON config file
  10. BTP CF MCP ServerCloud Foundry V3 API on SAP BTP as MCP tools
  11. BTP MCP ServerBTP Core Services as MCP tools with in-chat dashboards
  12. btp-sap-odata-to-mcp-serverExposes S/4HANA or ECC OData services as MCP tools
  13. CI MCP ServerSAP Cloud Integration OData APIs as MCP tools
  14. odata-mcp-proxyConfig-driven proxy turning OData and REST endpoints into MCP tools
  15. sap-pi-mcp-serverMCP server for SAP PI and PO monitoring and directory metadata
  16. sap-bdc-mcp-serverMCP server managing Delta shares in SAP Business Data Cloud
  17. @mariodefe/sap-datasphere-mcpMCP server with forty-five tools across a Datasphere tenant
  18. midasol/sap-mcp-serverPython MCP server for SAP Gateway OData operations
  19. odata_mcp_goGo binary bridging any OData v2 or v4 service to MCP
  20. odata_mcpPython bridge generating MCP tools from OData v2 metadata
  21. sap-bdc-mcpMCP tooling for SAP Business Data Cloud discovery and contracts
  22. mcp-sap-datasphere-serverRead-only MCP server for exploring SAP Datasphere
  23. sac-workbench-mcpMCP server for authoring in SAP Analytics Cloud from an assistant
  24. MCP Server for SAP BTP AdministrationSAP-hosted MCP endpoint for BTP account administration
  25. SAP LeanIX MCP ServerHosted MCP endpoint onto an SAP LeanIX instance
  26. SAP-samples/hana-cli-claude-pluginClaude Code plugin registering hana-cli's MCP server
  27. SAP-samples/hana-developer-cli-tool-exampleDeveloper-centric command line for SAP HANA
  28. cpi-mcp-serverGo MCP server over Cloud Integration packages and integration flows

Details

Sources3
sap-ai-mcp-serversdiscovered herechecked
github.com/Keelside/mcp-sap-cpitree, pushes, contributors, CIchecked
README.mdquoted, and what the entry declareschecked

Sources are graph entities: the same page may back several entries, and an unreachable source flags every row that rests on it.

Compatibility and provenance
discovered viasap-ai-mcp-servers
first seen in the atlas
ecosystem and domainbtp, integration-and-messaging
Contributors1

From the repository’s contributor list, .

History in the atlas3
  1. The concern it answers is reaching into an SAP system from outside, split out of MCP servers on this day; the sentence on the edge is unchanged.
  2. Triaged out of data/crawled/mcp-candidates.json, the sap-ai-mcp-servers sweep. Written from the repository's own README. Filed on the BTP door: the Integration Suite is BTP services, which is the reasoning the door list has carried since it was written.
  3. First seen.
For your agent
Ref
artifact:keelside-mcp-sap-cpi
JSON
/artifacts/keelside-mcp-sap-cpi.json
MCP
Connecting an agent