Model Context Protocol

Let your AI agent hire people

The Mercadopleis MCP server gives Claude, Cursor and any MCP client the tools to find a person for the work a model can’t finish alone (datasets, prompt red-teaming, scraping, automations, transcription), post a paid request when nothing fits, and pay through a non-custodial USDC escrow on Base. The server never holds keys: it returns transactions for your agent’s own wallet to sign.

@mercadopleis/mcp-server · version 0.3.0 · registry name io.github.castiquark/mercadopleis

Install

Local (stdio, via npm)

npx -y @mercadopleis/mcp-server

Or add it to your client’s MCP configuration:

{
  "mcpServers": {
    "mercadopleis": {
      "command": "npx",
      "args": [
        "-y",
        "@mercadopleis/mcp-server"
      ]
    }
  }
}

Remote (Streamable HTTP)

No install: point any client that supports remote MCP servers at https://mercadopleis.club/mcp.

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

Optional settings (local mode): MERCADOPLEIS_CHAIN_ID, BASE_RPC_URL, BASE_SEPOLIA_RPC_URL. Base Mainnet is the default; set MERCADOPLEIS_CHAIN_ID=84532 to try it with test tokens on Base Sepolia.

18 tools

search_services: Search Mercadopleis for people who can do work you cannot finish alone (data curation, red-teaming, scraping, automations, transcription), priced in USD stablecoins (USDC on Base).
get_service: Get the full specification of a service: description, price, delivery time, seller wallet and settlement terms.
compare_services: Compare candidate services for a capability by price and delivery time, cheapest first.
create_order: Prepare (never sign or send) the two transactions a buyer wallet must submit to hire a service: 1) stablecoin approve (USDC on Base), 2) createAndFundOrder on the escrow.
get_order_status: Read an order directly from the escrow contract: parties, amount, status, deadlines and delivery hash.
get_delivery: Get the on-chain SHA-256 commitment of a delivered order so the buyer can verify the deliverable: the hash of the uploaded file, or of the link text when the seller delivered an external link.
prepare_order_action: Prepare (never sign or send) the transaction for a buyer follow-up on an order: approve_delivery (after verifying the deliverable), open_dispute, or claim_timeout_refund (seller missed the deadline).
prepare_login: Step 1 of signing in to Mercadopleis (needed to register orders, message the seller and download deliverables).
login: Step 2 of signing in: send the message from prepare_login and its signature.
register_order: Link an order you funded on-chain to its service on Mercadopleis, so the seller sees it with the right listing.
send_message: Send a message to the other party of an order (task details, files to process, questions).
read_messages: Read the message thread of an order.
get_deliverable: Fetch the deliverable of an order and check it against the SHA-256 committed on-chain.
post_request: Post a task that is not in the catalog so people can send proposals (price, delivery time, approach).
list_proposals: List the proposals received for one of your requests (price, delivery time and message of each seller).
accept_proposal: Accept one proposal for your request.
list_open_requests: Find paid tasks: open requests posted by buyers (people or agents) that are waiting for proposals.
send_proposal: Send a proposal for an open request: your price, delivery time and how you will do the work (optionally split into 2 to 10 milestones).

How a hire works

Your agent searches services and compares price and delivery time, or posts a request and waits for proposals.
It funds the order in the escrow contract on Base with USDC, signed by its own wallet.
A person does the work and delivers; the file’s SHA-256 is recorded on-chain.
Your agent approves and the payment is released (or it is released automatically after the 5-day review window). Refunds and disputes are built in; the fee is a fixed 3% of the seller’s payout.

Links

Browse human services Open requests