Skip to main content
Glama
VanshikaDhole

SAP Ariba MCP Server

by VanshikaDhole
OverviewSchemaRelated ServersScoreDiscussions
Python
Remote

SAP Ariba MCP Server

A Model Context Protocol (MCP) server that exposes 48 SAP Ariba APIs as Claude-compatible tools. Built with Python and FastMCP.

This enables Claude (or any MCP-compatible AI) to interact with SAP Ariba procurement, sourcing, supplier management, contracts, catalogs, and supply chain data via natural language.

API Reference: https://help.sap.com/docs/ariba-apis Developer Portal: https://developer.ariba.com

Architecture

┌─────────────────────────────────────────────────┐
│  Consumer Layer                                  │
│  Claude Desktop / Claude Code / Custom App       │
└────────────────────┬────────────────────────────┘
                     │ MCP (stdio)
┌────────────────────▼────────────────────────────┐
│  ariba-mcp Server (this project)                 │
│                                                  │
│  ┌──────────┐  ┌──────────┐  ┌──────────┐       │
│  │ 6 Domain │  │ Auth     │  │ Client   │       │
│  │ Folders  │──│ OAuth2.0 │──│ httpx    │       │
│  │ 48 APIs  │  │ cached   │  │ async    │       │
│  └──────────┘  └──────────┘  └────┬─────┘       │
└────────────────────────────────────┼─────────────┘
                                     │ HTTPS
┌────────────────────────────────────▼─────────────┐
│  SAP Ariba APIs                                   │
│  OAuth: api.ariba.com                             │
│  Data:  openapi.ariba.com/api                     │
└──────────────────────────────────────────────────┘

All 48 APIs — 6 Domain Folders

1. Business Network — tools/business_network/

API

Owner

Ariba Network Purchase Orders API

Anil

Purchase Orders Supplier API

Nitish SM

Order Change Requests API for Buyers

Anim

Order Change Requests API for Suppliers

Shabreen

Ariba Network Invoice Header Data Extraction API

Ayub

Ship Notice API for Buyers

Ayub

Ship Notice API for Suppliers

Shabreen

Planning Collaboration Buyer API

Anim

Planning Collaboration Supplier API

Shabreen

Trading Partner Profile Certification API

Ayub

Supplier Information API

Shabreen

Proof of Service API for Buyers

(unassigned)

Data Replication Status for Multi-ERP

Ayub

Transaction Monitoring API

Anim

2. Catalog — tools/catalog/

API

Owner

Internal Catalogs Shop API

Anil

Public Catalogs Shop API

Anil

Network Catalog Management API

Anil

SAP Ariba Catalog Content API

Ayub

Catalog Connectivity Service API

Ayub

Content Lookup API

Anil

Materials and BOM Tag Management API

Anil

3. General — tools/general/

API

Owner

Document Approval API

Anim

Audit Search API

Vanshika

Integration Monitoring API for Procurement

Vanshika

Integration Monitoring API for Strategic Sourcing

Pranathi

Master Data Integration Job Status API

Anim

Configuration Parameter Review API

Vanshika

SAP Ariba Custom Forms API

Vanshika

Asset Management API

Rohit Naik

Master Data Retrieval API for Procurement

Rohit Naik

Guided Buying Functional Documents API

Anim

Create Procurement Workspace API

Vanshika

User Qualification API

Anil

Public Procurement Notices Export API

Rohit Naik

NDA Data Export API

Rohit Naik

4. Procurement — tools/procurement/

API

Owner

Operational Reporting API for Procurement

Vanshika

Analytical Reporting API (Strategic & Operational)

Anim

Contract Compliance API

Vanshika

Contract Workspace Retrieval API

Anim

Contract Workspace Management APIs

Rohit Naik

Contract Terms Management API

Shabreen

Cost Breakdown Data Extraction API

Vanshika

5. Strategic Sourcing — tools/strategic_sourcing/

API

Owner

Operational Reporting API for Strategic Sourcing

Pranathi

Sourcing Project Management API

Pranathi

Event Management API

Anim

External Approval API for Sourcing & Supplier Mgmt

Pranathi

Master Data Retrieval API for Sourcing

Pranathi

Pricing API for Product Sourcing

Pranathi

Surrogate Bid API

Rohit Naik

Product Hierarchy Management API

Shabreen

Bill of Materials Import API

Anim

6. Supplier Management — tools/supplier_management/

API

Owner

Supplier Data API with Pagination

Nitish SM

Supplier Data API

Nitish SM

Supplier Data Extraction API

Nitish SM

Ariba Network Supplier Profile API

Nitish SM

Supplier Invite API

Nitish SM

Supplier Risk Engagements API

Nitish SM

Risk Exposure API

Anim

Risk Category Information API

Shabreen

Prerequisites

  • Python 3.11+

  • uv (recommended) or pip

  • SAP Ariba API credentials — one person provisions them for the team

Credential Setup (One-time)

One team member registers on the SAP Ariba Developer Portal and shares credentials:

  1. Go to https://developer.ariba.com

  2. Register a new application

  3. Enable the APIs needed

  4. Note: OAuth Client ID, Client Secret, API Key, Realm name

  5. Create .env and share securely:

cp .env.example .env
# Fill in credentials

Never commit .env to git.

Quick Start

# Clone and install
git clone https://github.com/nitishsm2002/ariba-mcp.git
cd ariba-mcp
uv venv && source .venv/bin/activate
uv pip install -e ".[dev]"

# Add .env file (get from credentials owner)

# Run the server
python -m ariba_mcp.server

# Test with MCP Inspector
npx @modelcontextprotocol/inspector python -m ariba_mcp.server

Connect to Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "ariba": {
      "command": "python",
      "args": ["-m", "ariba_mcp.server"],
      "cwd": "/path/to/ariba-mcp"
    }
  }
}

Project Structure

ariba-mcp/
├── src/ariba_mcp/
│   ├── server.py                       # FastMCP entrypoint
│   ├── config.py                       # Settings (reads .env)
│   ├── auth.py                         # OAuth 2.0 client credentials
│   ├── client.py                       # Async HTTP client (views, jobs, resources)
│   ├── errors.py                       # Error handling
│   ├── models/common.py               # Shared Pydantic models
│   └── tools/
│       ├── __init__.py                 # Registers all 6 domain folders
│       ├── business_network/           # 14 APIs — POs, invoices, ship notices, planning
│       │   ├── __init__.py
│       │   ├── _example.py
│       │   └── <your_api>.py           # ← team members add files here
│       ├── catalog/                    # 7 APIs — catalogs, content, connectivity
│       │   ├── __init__.py
│       │   ├── _example.py
│       │   └── <your_api>.py
│       ├── general/                    # 14 APIs — approvals, audit, monitoring, config
│       │   ├── __init__.py
│       │   ├── _example.py
│       │   └── <your_api>.py
│       ├── procurement/                # 7 APIs — reporting, contracts, compliance
│       │   ├── __init__.py
│       │   ├── _example.py
│       │   └── <your_api>.py
│       ├── strategic_sourcing/         # 9 APIs — sourcing projects, events, bids
│       │   ├── __init__.py
│       │   ├── _example.py
│       │   └── <your_api>.py
│       └── supplier_management/        # 8 APIs — supplier data, risk, profiles
│           ├── __init__.py
│           ├── _example.py
│           └── <your_api>.py
├── tests/
├── .agents/skills/mcp-builder/        # MCP builder reference docs
├── pyproject.toml
├── .env.example
├── CONTRIBUTING.md
└── .gitignore

How to Implement Your API

Each folder has a _example.py with a working tool to copy from. To add your API:

  1. Find the right folder in src/ariba_mcp/tools/ (see table above)

  2. Look at _example.py in that folder for the pattern

  3. Create a new .py file named after your API (e.g. supplier_data_extraction.py)

  4. Define a register(mcp, client) function with your @mcp.tool inside it

  5. Open the folder's __init__.py and add your import + register() call

  6. Look up the exact endpoint path on the Developer Portal

  7. Test with MCP Inspector: npx @modelcontextprotocol/inspector python -m ariba_mcp.server

See CONTRIBUTING.md for detailed coding patterns.

Configuration Reference

Variable

Required

Default

Description

ARIBA_REALM

Yes

—

Ariba realm (e.g. mycompany-T)

ARIBA_CLIENT_ID

Yes

—

OAuth 2.0 client ID

ARIBA_CLIENT_SECRET

Yes

—

OAuth 2.0 client secret

ARIBA_API_KEY

Yes

—

Application key

ARIBA_OAUTH_URL

No

https://api.ariba.com

OAuth endpoint

ARIBA_API_URL

No

https://openapi.ariba.com/api

API base URL

License

MIT

McpServer

This server cannot be installed

-
security - not tested
F
license - not found
-
quality - not tested

How are these scores calculated?

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/VanshikaDhole/McpServer'

If you have feedback or need assistance with the MCP directory API, please join our Discord server