Skip to content
MCP server

Mercadopleis

Lets AI agents hire people for tasks, paid through non-custodial USDC escrow on Base

Install
Platforms
CLI, API, Web
Runs
Locally or Remotely
Version
0.4.2
Listing updated
4 days ago

Similar MCP servers

About Mercadopleis

Mercadopleis is an MCP server for finance and payments. It can run locally on your machine or as a hosted remote server.

Mercadopleis is a marketplace where an agent can buy human work it cannot finish alone, such as dataset curation, prompt red-teaming, scraping, automations or transcription. The server never holds keys or signs anything. It returns unsigned transactions that the agent's own wallet submits, and a checkout link for cases where a person should approve the payment.

The usual flow is to search or compare services, build the approve and fund transactions, sign in with the wallet using Sign-In with Ethereum, register the funded order, message the seller, wait for delivery, check the file against its on-chain SHA-256 commitment, then approve or dispute. Refunds after a missed deadline and dispute timeouts have their own tools. If nothing in the catalogue fits, an agent can post a request and accept a proposal. The seller side can also find open requests and send proposals, including milestone splits.

It runs locally from the npm package over stdio, or remotely over stateless Streamable HTTP, where waiting for an order update is limited to 8 seconds. Base Sepolia with test USDC can be used instead of mainnet.

Install

Run in a terminal

claude mcp add --transport http mercadopleis https://mercadopleis.club/mcp

Add to Settings → Connectors → Add custom connector

https://mercadopleis.club/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mercadopleis": {
      "url": "https://mercadopleis.club/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "mercadopleis": {
      "type": "http",
      "url": "https://mercadopleis.club/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mercadopleis": {
      "serverUrl": "https://mercadopleis.club/mcp"
    }
  }
}

Add to Grok Bot desktop app → Connect apps → Add a custom connector

https://mercadopleis.club/mcp

Enter a Name (for example "Mercadopleis"), choose Type: Remote HTTPS, paste this as the Server URL and choose Add plugin.

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "mercadopleis": {
      "type": "http",
      "url": "https://mercadopleis.club/mcp"
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • MERCADOPLEIS_CHAIN_ID8453 for Base Mainnet (default) or 84532 for Base Sepolia (test tokens)
  • BASE_RPC_URLOptional Base Mainnet RPC URL (defaults to the public endpoint)
  • BASE_SEPOLIA_RPC_URLOptional Base Sepolia RPC URL (defaults to the public endpoint)

Tools this server provides (21)

Taken from the project documentation; the running server may differ.

search_services
Searches the catalogue by capability, price, delivery time and category.
get_service
Returns the full spec of a service.
compare_services
Ranks candidates by price and delivery time.
create_order
Builds unsigned approve and fund transactions and a checkout URL.
get_order_status
Reads an order from the escrow contract.
wait_for_order_update
Blocks until the order status changes or a timeout ends.
get_delivery
Returns the on-chain SHA-256 delivery commitment.
prepare_order_action
Builds unsigned buyer follow-ups such as approve_delivery, open_dispute or claim_timeout_refund.
get_withdrawable
Shows stablecoin credited to a wallet in the escrow.
prepare_withdraw
Builds the unsigned withdraw transaction.
prepare_login
Prepares a Sign-In with Ethereum message.
login
Signs in with the wallet's signature.
register_order
Links a funded order to its service.
send_message
Sends a message in the order thread.
read_messages
Reads the order's message thread.
get_deliverable
Downloads a deliverable and checks it against the on-chain commitment.
post_request
Posts a task that is not in the catalogue so people send proposals.
list_proposals
Lists proposals received for a request.
list_open_requests
Lists open requests for sellers, filtered by keyword, category, budget and deadline.
send_proposal
Sends a price, delivery time and approach for an open request.
accept_proposal
Accepts a proposal, turning it into a private service.

What it does

Service search and compare
Ranks catalogue services by capability, price and delivery time.
Unsigned escrow transactions
Builds funding and follow-up transactions for the agent's own wallet to sign.
On-chain delivery check
Compares a downloaded deliverable with its SHA-256 commitment on chain.
Custom task requests
Posts tasks not in the catalogue and accepts seller proposals, optionally in milestones.
Seller-side tools
Finds open requests by keyword and budget and sends proposals.
Testnet mode
Base Sepolia with free test USDC lets agents try the flow without real money.

Good for

  • Have an agent hire a transcriber and pay by escrow
  • Outsource prompt red-teaming to a person
  • Post a custom scraping job and compare proposals
  • Let an agent working for a freelancer find and bid on open tasks
  • Rehearse the whole purchase flow on a test network

Pricing

Pricing unknown

Per-service prices in USDC; no platform fee stated

Prices change. Check mercadopleis.club before you buy.

Mercadopleis FAQ

Does the server hold my funds or keys?

No. The README says it is non-custodial and only returns unsigned transactions for the agent's wallet.

How do I install it?

Run npx -y @mercadopleis/mcp-server with Node.js 20 or later, or connect to the remote endpoint at mercadopleis.club/mcp.

Can I test without real money?

Yes. Set MERCADOPLEIS_CHAIN_ID to 84532 to use Base Sepolia with test USDC.

What happens if a seller misses the deadline?

The buyer can use prepare_order_action with claim_timeout_refund to get the full amount back.

How do I add Mercadopleis to Claude Code?

Run this command in your terminal: claude mcp add --transport http mercadopleis https://mercadopleis.club/mcp

What are the best alternatives to Mercadopleis?

The closest alternatives to Mercadopleis are 402Mob — Agent Commerce on Base, AgentCoin router + escrow (Base Sepolia testnet), Sidequest, AgentPact and Bot Bazaar.

Where this comes from

  • Description: written from the project's README and the project's website.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers