# mcp-zoop

Connects Zoop marketplace payment services to AI agents. It handles Pix charges, multi-seller splits, bank transfers, and disputes directly from chat.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 274
- Author: codespar
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/codespar/mcp-dev-latam/tree/HEAD/packages/payments/zoop
- Updated: 2026-09-27
- HTML: https://affpapa.org/en/nevibecode/mcp/mcp-zoop

## What it does

This server exposes 28 tools mapped to the Zoop marketplace API. The assistant can charge customers through Pix, cards, or boleto, tokenize payment credentials, and register both buyers and sellers. It also configures split rules across several merchants and handles full or partial refunds.

Payout management works out of the box. Agents can inspect seller balances, initiate transfers to linked bank accounts, and fetch recurring subscription records.

Execution requires `ZOOP_API_KEY` and `ZOOP_MARKETPLACE_ID` in the environment. Without these credentials, Basic Auth requests fail immediately, so configure a sandbox account before running live workflows.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `ZOOP_API_KEY` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add mcp-zoop -e ZOOP_API_KEY=<ZOOP_API_KEY> -- npx -y @codespar/mcp-zoop
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add zoop --env ZOOP_API_KEY=<ZOOP_API_KEY> -- npx -y @codespar/mcp-zoop
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "zoop": {
            "command": "npx",
            "args": [
                "-y",
                "@codespar/mcp-zoop"
            ],
            "env": {
                "ZOOP_API_KEY": "<ZOOP_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "zoop": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@codespar/mcp-zoop"
            ],
            "env": {
                "ZOOP_API_KEY": "<ZOOP_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e ZOOP_API_KEY=<ZOOP_API_KEY> zoop npx -y @codespar/mcp-zoop
```
Replace <…> with your own values

## When to use it
- distribute customer checkouts across marketplace sellers using split rules
- generate Pix transactions with copy-paste payloads and QR codes
- transfer collected funds to seller bank accounts
- inspect chargeback disputes and seller balances through your assistant

## Example prompts
- Generate a Pix transaction for 200 BRL with a split rule between seller A and seller B
- Check the current balance for seller `sel_123` and trigger a bank transfer
- List all active payment disputes registered in the marketplace

## Similar
- [World Monitor](https://affpapa.org/en/nevibecode/mcp/world-monitor.md) — MCP server · ★ 89408
- [CCXT](https://affpapa.org/en/nevibecode/mcp/ccxt.md) — MCP server · ★ 44583
- [Finance Toolkit](https://affpapa.org/en/nevibecode/mcp/finance-toolkit.md) — MCP server · ★ 5458
- [EdgarTools](https://affpapa.org/en/nevibecode/mcp/edgartools.md) — MCP server · ★ 2814
- [LetsFG — Flights & Hotels](https://affpapa.org/en/nevibecode/mcp/letsfg-flights-hotels.md) — MCP server · ★ 2188
- [AutoTS](https://affpapa.org/en/nevibecode/mcp/autots.md) — MCP server · ★ 1434

From the same set: [codespar/mcp-dev-latam](https://affpapa.org/en/nevibecode/by/codespar/mcp-dev-latam.md) — 124 cards

---
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