Mcp Zoop

io.github.codesparPublished by GitHub account codesparv0.1.4Updated Oct 24, 2026

MCP server for Zoop — marketplace payments, splits, sellers, buyers, transfers

VerifiedSTDIODesktop onlyFinanceBusiness & Commerce

Overview

AI-generated overview

MCP server for the Zoop marketplace payments platform, letting an assistant create transactions, splits, sellers, buyers and transfers.

What you can do
  • Create and look up transactions, including Pix, boleto and credit card payments, with refunds and receivables
  • Create and manage split rules that distribute payments between sellers
  • Create, update and list sellers and buyers, and read seller or marketplace balances
  • Create and list transfers to seller bank accounts, and tokenize cards and bank accounts
  • Create, list, get and cancel recurring subscriptions
  • List and inspect disputes and chargebacks, and read marketplace settings
When to use it
Useful when you work with the Zoop Brazilian marketplace payments platform and want an assistant to draft or inspect transactions, splits, sellers, transfers, subscriptions and disputes through conversation instead of the dashboard.
Requirements
Runs locally over stdio, typically launched with npx from the npm package, so Node.js is needed. Requires a Zoop developer account and two environment variables: ZOOP_API_KEY and ZOOP_MARKETPLACE_ID. A sandbox environment is available for testing.
Before you install
The API key in ZOOP_API_KEY is a payment credential sent as Basic Auth; keep it out of shared configs. Many tools move money or change records: creating transactions, transfers, refunds, split rules, subscriptions and card or bank account tokens. Test in the sandbox first, and note that card tokenization sends card data to Zoop.

Installation

In SourceWeft

  1. Open Mcp Zoop in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

@codespar/mcp-zoop

MCP server for Zoop — marketplace payments with split rules

[npm] [License: MIT]

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)

ToolPurpose
create_transactionCreate a transaction in Zoop (Pix, boleto, or credit card)
get_transactionGet transaction details by ID
list_transactionsList transactions with optional filters
create_split_ruleCreate a split rule for distributing payments between sellers
create_sellerCreate a seller (individual or business) in the marketplace
get_sellerGet seller details by ID
list_sellersList sellers in the marketplace
create_buyerCreate a buyer in the marketplace
get_balanceGet balance for a seller or the marketplace
create_transferCreate a transfer to a seller's bank account
refund_transactionRefund a transaction (full or partial)
get_receivablesGet receivables for a transaction
create_token_cardTokenize a credit card for secure payments
create_bank_accountCreate a bank account token for a seller
get_seller_balanceGet detailed balance for a specific seller
update_sellerUpdate seller information
list_transfersList marketplace transfers with filters
get_transferGet transfer details by ID
create_subscriptionCreate a recurring subscription
list_receivablesList all receivables for the marketplace
create_pix_paymentCreate a PIX payment transaction
get_pix_paymentGet PIX payment details including QR code and copy-paste payload
cancel_subscriptionCancel a recurring subscription
list_subscriptionsList subscriptions in the marketplace
list_disputesList disputes/chargebacks in the marketplace
get_marketplaceGet marketplace information and settings
get_disputeGet dispute details by ID
get_subscriptionGet 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

VariableRequiredDescription
ZOOP_API_KEYYesAPI key from Zoop dashboard
ZOOP_MARKETPLACE_IDYesMarketplace 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

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

Source: packages/payments/zoop/README.md at commit d0a519a

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.1.4LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts