# Mercadopleis

> Mercadopleis is an MCP server for finance and payments. Lets AI agents hire people for tasks, paid through non-custodial USDC escrow on Base. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Platforms:** CLI, API, Web
- **Website:** https://mercadopleis.club
- **Repository:** https://github.com/castiquark/mercadopleis/tree/HEAD/packages/mcp-server
- **MCP Registry name:** io.github.castiquark/mercadopleis
- **Categories:** [finance and payments](https://ai-powered.com/categories/finance-and-payments), [hiring and recruiting](https://ai-powered.com/categories/hiring-and-recruiting)
- **Listing updated:** 2026-11-15

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://mercadopleis.club/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mercadopleis": {
      "url": "https://mercadopleis.club/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Grok Bot (Grok Bot desktop app → Connect apps → Add a custom connector)

```sh
https://mercadopleis.club/mcp
```

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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.

## 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.

## Alternatives

- [402Mob — Agent Commerce on Base](https://ai-powered.com/mcp/402mob-agent-commerce-on-base): 402Mob — Agent Commerce on Base is a paid MCP server for finance and payments.
- [AgentCoin router + escrow (Base Sepolia testnet)](https://ai-powered.com/mcp/agentcoin-router-escrow-base-sepolia-testnet): AgentCoin router + escrow (Base Sepolia testnet) is a free MCP server for finance and payments.
- [Sidequest](https://ai-powered.com/mcp/sidequest-2): Sidequest is an MCP server for finance and payments.
- [AgentPact](https://ai-powered.com/mcp/agentpact): AgentPact is a freemium MCP server for finance and payments.
- [Bot Bazaar](https://ai-powered.com/mcp/bot-bazaar): Bot Bazaar is a freemium MCP server for finance and payments.
- [Sphere Marketplace](https://ai-powered.com/mcp/sphere-marketplace): Sphere Marketplace is a free MCP server for ai models and llm tooling.
- [Panal](https://ai-powered.com/mcp/panal): Panal is an MCP server for finance and payments.
- [Wever Pay Exchange](https://ai-powered.com/mcp/wever-pay-exchange): Wever Pay Exchange is an MCP server for finance and payments.

---
Source: https://ai-powered.com/mcp/mercadopleis
