# SAP MCP Server

An MCP server that gives your agent typed tools for Solana and the SAP protocol, over local stdio or remote Streamable HTTP. Useful when the agent has to read chain data and pay for calls.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 3
- Author: OOBE-PROTOCOL
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/OOBE-PROTOCOL/sap-mcp
- Updated: 2026-10-11
- HTML: https://affpapa.org/en/nevibecode/mcp/sap-mcp-server

## What it does

SAP MCP Server publishes one typed tool registry through two launch modes: a local stdio process and a remote Streamable HTTP endpoint at `/mcp`. Hosted agents point at `https://mcp.sap.oobeprotocol.ai/mcp`, while transaction signing stays in the user's hands.

A setup wizard manages profiles under `~/.config/mcp-sap`. There are local and external signing modes, optional Bento policy, x402 monetization, and generation of a pay.sh provider config. Paid and write calls need the separate local `sap_payments` bridge; without it those tools will not go through. The agent wallet lives in `~/.config/mcp-sap/keypairs/`, and the wizard leaves the Solana CLI keypair alone.

Building from source means pnpm only: Node.js 22.12.0 or newer plus pnpm 11.7.0. `npm install` is not the path here, the repository is locked to pnpm. Read-only remote discovery works without a local signer.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://mcp.sap.oobeprotocol.ai/mcp`
- Environment variables: `SAP_MCP_ALLOW_ENV_CONFIG_OVERRIDE`, `SAP_LOG_LEVEL` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

1. **Platform CLI: remote server**
```bash
claude mcp add --transport http sap-mcp https://mcp.sap.oobeprotocol.ai/mcp
```

2. **Platform CLI**
```bash
claude mcp add --env SAP_MCP_ALLOW_ENV_CONFIG_OVERRIDE=<SAP_MCP_ALLOW_ENV_CONFIG_OVERRIDE> --env SAP_LOG_LEVEL=<SAP_LOG_LEVEL> --transport stdio sap-mcp-server -- npx -y @oobe-protocol-labs/sap-mcp-server
```
Replace <…> with your own values

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add sap-mcp-server --url https://mcp.sap.oobeprotocol.ai/mcp
```

2. **Platform CLI**
```bash
codex mcp add sap-mcp-server --env SAP_MCP_ALLOW_ENV_CONFIG_OVERRIDE=<SAP_MCP_ALLOW_ENV_CONFIG_OVERRIDE> --env SAP_LOG_LEVEL=<SAP_LOG_LEVEL> -- npx -y @oobe-protocol-labs/sap-mcp-server
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "sap-mcp-server": {
            "url": "https://mcp.sap.oobeprotocol.ai/mcp"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "sap-mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "@oobe-protocol-labs/sap-mcp-server"
            ],
            "env": {
                "SAP_MCP_ALLOW_ENV_CONFIG_OVERRIDE": "<SAP_MCP_ALLOW_ENV_CONFIG_OVERRIDE>",
                "SAP_LOG_LEVEL": "<SAP_LOG_LEVEL>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "sap-mcp-server": {
            "type": "http",
            "url": "https://mcp.sap.oobeprotocol.ai/mcp"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "sap-mcp-server": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@oobe-protocol-labs/sap-mcp-server"
            ],
            "env": {
                "SAP_MCP_ALLOW_ENV_CONFIG_OVERRIDE": "<SAP_MCP_ALLOW_ENV_CONFIG_OVERRIDE>",
                "SAP_LOG_LEVEL": "<SAP_LOG_LEVEL>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http sap-mcp-server https://mcp.sap.oobeprotocol.ai/mcp
```

2. **Platform CLI**
```bash
gemini mcp add -e SAP_MCP_ALLOW_ENV_CONFIG_OVERRIDE=<SAP_MCP_ALLOW_ENV_CONFIG_OVERRIDE> -e SAP_LOG_LEVEL=<SAP_LOG_LEVEL> sap-mcp-server npx -y @oobe-protocol-labs/sap-mcp-server
```
Replace <…> with your own values

## When to use it
- wire an agent into Solana over MCP
- split read-only calls from paid ones across two servers
- set up an agent wallet profile without touching the Solana CLI keypair
- charge for tool calls through x402
- run a remote MCP endpoint for hosted agents

## Example prompts
- Start SAP MCP.
- Show the active profile and run `npx sap-mcp-config doctor` on it.
- Create a new profile with `npx sap-mcp-config wizard`.

## Similar
- [mpp32-mcp-server](https://affpapa.org/en/nevibecode/mcp/mpp32-mcp-server.md) — MCP server · ★ 221
- [agentwallet](https://affpapa.org/en/nevibecode/skills/agentwallet.md) — skill · 2600 installs
- [x402 Universal Payer](https://affpapa.org/en/nevibecode/mcp/x402-universal-payer.md) — MCP server · ★ 250
- [Agent Wormhole](https://affpapa.org/en/nevibecode/mcp/agent-wormhole.md) — MCP server · ★ 5
- [sap-fiori-app-development](https://affpapa.org/en/nevibecode/skills/sap-fiori-app-development.md) — skill · 595 installs
- [sap-abap](https://affpapa.org/en/nevibecode/skills/sap-abap.md) — skill · 1300 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
