@codespar/mcp-zoop

MCP server for Zoop — marketplace payments with split rules

Quick Start

Claude Desktop

Add to ~/.config/claude/claude_desktop_config.json:

{
  "mcpServers": {
    "zoop": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-zoop"],
      "env": {
        "ZOOP_API_KEY": "your-key",
        "ZOOP_MARKETPLACE_ID": "your-marketplace-id"
      }
    }
  }
}

Claude Code

claude mcp add zoop -- npx @codespar/mcp-zoop

Cursor / VS Code

Add to .cursor/mcp.json or .vscode/mcp.json:

{
  "servers": {
    "zoop": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-zoop"],
      "env": {
        "ZOOP_API_KEY": "your-key",
        "ZOOP_MARKETPLACE_ID": "your-marketplace-id"
      }
    }
  }
}

Tools (28)

| Tool | Purpose | |---|---| | create_transaction | Create a transaction in Zoop (Pix, boleto, or credit card) | | get_transaction | Get transaction details by ID | | list_transactions | List transactions with optional filters | | create_split_rule | Create a split rule for distributing payments between sellers | | create_seller | Create a seller (individual or business) in the marketplace | | get_seller | Get seller details by ID | | list_sellers | List sellers in the marketplace | | create_buyer | Create a buyer in the marketplace | | get_balance | Get balance for a seller or the marketplace | | create_transfer | Create a transfer to a seller's bank account | | refund_transaction | Refund a transaction (full or partial) | | get_receivables | Get receivables for a transaction | | create_token_card | Tokenize a credit card for secure payments | | create_bank_account | Create a bank account token for a seller | | get_seller_balance | Get detailed balance for a specific seller | | update_seller | Update seller information | | list_transfers | List marketplace transfers with filters | | get_transfer | Get transfer details by ID | | create_subscription | Create a recurring subscription | | list_receivables | List all receivables for the marketplace | | create_pix_payment | Create a PIX payment transaction | | get_pix_payment | Get PIX payment details including QR code and copy-paste payload | | cancel_subscription | Cancel a recurring subscription | | list_subscriptions | List subscriptions in the marketplace | | list_disputes | List disputes/chargebacks in the marketplace | | get_marketplace | Get marketplace information and settings | | get_dispute | Get dispute details by ID | | get_subscription | Get subscription details by ID |

Authentication

Zoop uses Basic Auth with the API key as username and empty password.

Sandbox / Testing

Zoop provides a sandbox environment accessible via the dashboard.

Get your credentials

1. Go to Zoop Documentation
2. Create a developer account
3. Get your API key and marketplace ID from the dashboard
4. Set the environment variables

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | ZOOP_API_KEY | Yes | API key from Zoop dashboard | | ZOOP_MARKETPLACE_ID | Yes | Marketplace ID |

Roadmap

v0.2 (planned)

• get_dispute — Get dispute details by ID
• respond_dispute — Respond to a dispute with evidence
• list_plans — List all subscription plans
• update_subscription — Update a subscription's details
• cancel_subscription — Cancel an active subscription

v0.3 (planned)

• batch_transfers — Process multiple transfers in a single request
• detailed_reports — Generate detailed financial reports
• webhook_management — Register, list, and delete webhooks

Want to contribute? Open a PR or request a tool.

Links

• Zoop Website
• Zoop API Documentation
• MCP Dev Brasil
• Landing Page

Enterprise

Need governance, budget limits, and audit trails for agent payments? CodeSpar Enterprise adds policy engine, payment routing, and compliance templates on top of these MCP servers.

License

MIT