DISCLAIMER: This server is still experimental. Use at your own risk!

MCP Trading Partner Management

A ModelContextProtocol (MCP) Server for SAP Integration Suite Trading Partner Management

I highly recommend using this Server along with https://github.com/1nbuc/mcp-integration-suite which provides tools for general CPI Functions

Requirements

Java and Gradle (Java > 17, Gradle > 8)

Installation

git clone https://github.com/1nbuc/mcp-is-tpm.git
cd mcp-is-tpm
./gradlew build

Add this to your AI Clients MCP Config.

This code snippets shows how to use it together with the MCP Integration suite server, which is optional.

If your S or P user is associated with a Universal ID, you have to provide details as below.

Please also use your Universal ID Password.

If you have a standalone S-User, delete the CPI_UNIVERSAL_MAIL variable

{
  "mcpServers": {
    "mcp-is": {
      "command": "node",
      "args": [
        "/dist/index.js"
      ],
      "autoApprove": []
    },
    "mcp-is-tpm": {
      "command": "java",
      "args": [
        "-Dlogging.pattern.console=", 
        "-Dspring.main.web-application-type=none",
        "-Dspring.ai.mcp.server.stdio=true",
        "-jar",
        "/app/build/libs/app-0.0.1-SNAPSHOT.jar"
      ],
      "autoApprove": [],
      "env": {
        "CPI_URL": "https://https://your.cpi.url.hana.ondemand.com",
        "CPI_USER": "S001234567",
        "CPI_PASSWORD": "myPass123",
        "CPI_UNIVERSAL_MAIL": "mail@company.de"
      }
    }
  }
}

Custom prompt

I highly recommend starting each chat with a custom prompt. You can find a recommended custom prompt here

Available Tools

• `get-partner-metadata`: Get metadata for all trading partners.
• `get-partner`: Get partner details by partner id.
• `create-trading-partner`: Create a new trading partner.
• `get-systems-of-partner`: Returns all systems of a trading partner by its ID.
• `create-system`: Create a system for a trading partner.
• `get-system-types`: Get available system types.
• `create-identifier`: Create a partner Identifier.
• `get-qualifiers-codelist`: Get codelist of a qualifier.
• `create-communication`: Create a communication channel for a system of a trading partner.
• `get-sender-adapters`: Get all sender adapters of trading partner systems.
• `get-receiver-adapters`: Get all receiver adapters of trading partner systems.
• `create-signature-verify-config`: Create Signature Verification configuration for a partner.
• `activate-signature-verify-config`: Activate Signature Verification configuration for a partner.
• `get-all-company-profile-metadata`: Get metadata for all company profiles.

Agreement Management

• `get-all-agreement-metadata`: Get metadata for all agreements.
• `get-all-agreement-template-metadata`: Get metadata for all agreement templates.
• `get-agreement-template`: Get all details for an agreement template.
• `create-agreement-with-bound-template`: Create a new B2B agreement which is bound to a template.
• `get-agreement-b2b-scenario`: Get the technical B2B scenario of an agreement.
• `update-b2b-scenario`: Update an Agreement's B2B Scenario.
• `trigger-agreement-activate-or-update-deployment`: Update or deploy an agreement.

Message Implementation Guideline (MIG) Management

• `get-all-mig-latest-metadata`: Get the latest metadata for all Message Implementation Guidelines (MIGs).
• `get-mig-raw-by-id`: Get raw MIG content by its version ID.
• `get-mig-nodes-xpath`: Get the Nodes of a MIG for a specified XPath.
• `get-all-mig-fields`: Get a List of all fields of a MIG.
• `get-mig-documentation-entry`: Get the documentation text for a id of a documentation within a mig.
• `get-mig-proposal`: Get Proposal for a MIG.
• `apply-mig-proposal`: Select fields based on MIG proposal.
• `create-mig-draft-all-segments-selected`: Creates a draft MIG from a source version, with all segments and fields pre-selected.
• `create-mig`: Create Message implementation guideline based on a type.
• `change-mig-field-selection`: Change the selection of MIG fields.

Mapping Guideline (MAG) Management

• `get-all-mags-metadata`: Get an overview of available Mapping guidelines.
• `create-mapping-guidelines`: Create a new mapping guidelines.
• `test-mag-with-message`: Send a message against a mapping guideline and get the result.

Monitoring

• `search-interchanges`: Search for interchanges/TPM message monitoring based on filter criteria.
• `get-interchange-payloads`: Get payload data list for a specific interchange.
• `download-interchange-payload`: Download a specific payload by its ID.
• `get-interchange-last-error`: Get last error details for a specific message/business document.

Other

• `get-type-systems`: Get available type systems.
• `get-type-system-messages`: Get messages of a type system.
• `get-type-system-message-full`: Get a message from a type system with all details including versions and revisions.
• `create-custom-message`: Create a custom message in typesystem Customer_TS based on XSD.
• `get-type-system-identifier-schemes`: Get the possible scheme for identifiers in a type system.
• `get-all-business-process-roles`: Get all business process roles.
• `get-all-business-processes`: Get all business processes.
• `get-all-industry-classifications`: Get all industry classifications.
• `get-all-product-classifications`: Get all product classifications.
• `get-all-products`: Get all available products/types for a system e.g. SAP SuccessFactors etc.
• `get-all-contries-or-regions`: Get all countries or regions.