mcp-zoop

@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 LATAM
• 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