# Orbis API Marketplace MCP server

> Connects AI agents to over 2,800 APIs using automated USDC micropayments on the Base network.

- Repository: https://github.com/OrbisAPI/orbis-mcp
- Page: https://hostedmcp.org/servers/orbisapi/orbis-mcp
- Transport: stdio
- Stars: 2
- License: MIT
- Latest version: 1.0.7

## Install

### Claude Code

```sh
claude mcp add --env 'WALLET_PRIVATE_KEY=<YOUR_WALLET_PRIVATE_KEY>' orbis-mcp -- npx -y @orbisapi/mcp
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "orbis-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@orbisapi/mcp"
      ],
      "env": {
        "WALLET_PRIVATE_KEY": "<YOUR_WALLET_PRIVATE_KEY>"
      }
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "orbis-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@orbisapi/mcp"
      ],
      "env": {
        "WALLET_PRIVATE_KEY": "<YOUR_WALLET_PRIVATE_KEY>"
      }
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"orbis-mcp","type":"stdio","command":"npx","args":["-y","@orbisapi/mcp"],"env":{"WALLET_PRIVATE_KEY":"<YOUR_WALLET_PRIVATE_KEY>"}}'
```

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "orbis-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@orbisapi/mcp"
      ],
      "env": {
        "WALLET_PRIVATE_KEY": "<YOUR_WALLET_PRIVATE_KEY>"
      }
    }
  }
}
```

### Codex

```sh
codex mcp add orbis-mcp --env 'WALLET_PRIVATE_KEY=<YOUR_WALLET_PRIVATE_KEY>' -- npx -y @orbisapi/mcp
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.orbis-mcp]
command = "npx"
args = ["-y", "@orbisapi/mcp"]

[mcp_servers.orbis-mcp.env]
WALLET_PRIVATE_KEY = "<YOUR_WALLET_PRIVATE_KEY>"
```

### Gemini CLI

```sh
gemini mcp add -s user -e 'WALLET_PRIVATE_KEY=<YOUR_WALLET_PRIVATE_KEY>' orbis-mcp npx -- -y @orbisapi/mcp
```

### Gemini settings.json (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "orbis-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@orbisapi/mcp"
      ],
      "env": {
        "WALLET_PRIVATE_KEY": "<YOUR_WALLET_PRIVATE_KEY>"
      }
    }
  }
}
```

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `WALLET_PRIVATE_KEY` | yes | yes | Base mainnet wallet private key — funds API call micropayments in USDC via x402 |

## Tools (4)

- `browse_apis`
- `call_api`
- `register_agent`
- `subscribe_to_api`

## FAQ

### How much does an API call cost?

Each API call costs approximately $0.01.

### How are payments processed?

Payments are handled automatically via the x402 protocol on the Base network.

### What tools are available through this server?

The server provides tools to browse APIs, call APIs, register agent wallets, and subscribe to APIs for discounts.
