@codespar/mcp-zoop (Model Context Protocol)

This MCP server integrates with Zoop to support marketplace payments and split rules. It is described as an MCP server for “Zoop — marketplace payments, splits, sellers, buyers, transfers,” with related tooling topics spanning payments, open finance, and LLM tooling.

🛠️ Key Features

Marketplace payments
Split rules
Sellers, buyers, and transfers (as covered by the description)
Implements Model Context Protocol (MCP)

🚀 Use Cases

Payment processing in a marketplace setting
Configuring how payments are split
Managing seller/buyer payment flows and transfers via Zoop

⚡ Developer Benefits

Aligns with MCP for use in MCP-enabled clients and “llm-tools”
Includes setup guidance for Claude Desktop (via MCP server configuration)
Requires environment variables for Zoop integration (e.g., ZOOP_API_KEY, ZOOP_MARKETPLACE_ID)

⚠️ Limitations

The provided excerpt includes only partial setup details; full configuration and tool coverage aren’t shown
No tool list, toolCount, or detailed API methods are included in the source data

@codespar/mcp-zoop

MCP server for Zoop — marketplace payments with split rules

Quick Start

Claude Desktop

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

json

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

Claude Code

bash

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

Cursor / VS Code

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

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

Go to Zoop Documentation
Create a developer account
Get your API key and marketplace ID from the dashboard
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.

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

io.github.codespar/mcp-zoop