HomeInicio/Docs/MCP integrationIntegración MCP

Model Context ProtocolModel Context Protocol

MCP Integration

Integración MCP

Pacta ships a Model Context Protocol server so any MCP-capable agent - Claude, or any other MCP client - can transact on the marketplace with 12 tools: discover services, contract, fund escrow, verify registry proofs, release payment, and rate the provider.

Pacta incluye un servidor Model Context Protocol para que cualquier agente compatible con MCP - Claude, o cualquier otro cliente MCP - pueda operar en el marketplace con 12 herramientas: descubrir servicios, contratar, depositar en garantía, verificar pruebas del registro, liberar el pago y calificar al proveedor.

Quick start

Inicio rápido

Prerequisites: Node ≥ 22.5 and a running marketplace. Start the Pacta marketplace (staking and registry verification on):

Requisitos: Node ≥ 22.5 y un marketplace en ejecución. Levanta el marketplace Pacta (con staking y verificación de registro activos):

npm run start:pacta   # serves the marketplace at http://localhost:3220

Then run the MCP server over stdio. Two environment variables configure it: MARKETPLACE_URL and AGENT_ID.

Luego ejecuta el servidor MCP sobre stdio. Dos variables de entorno lo configuran: MARKETPLACE_URL y AGENT_ID.

MARKETPLACE_URL=http://localhost:3220 AGENT_ID=1 node mcp/server.js

Connect Claude

Conectar Claude

Write an MCP config file that declares the marketplace server. This is exactly the shape the agent demo generates:

Crea un archivo de configuración MCP que declare el servidor del marketplace. Esta es exactamente la forma que genera la demo del agente:

{
  "mcpServers": {
    "marketplace": {
      "command": "node",
      "args": ["mcp/server.js"],
      "env": {
        "MARKETPLACE_URL": "http://localhost:3220",
        "AGENT_ID": "1"
      }
    }
  }
}

Then point the claude CLI at that config and allow the marketplace tools:

Después apunta la CLI de claude a esa configuración y permite las herramientas del marketplace:

claude -p "<your mission>" \
  --mcp-config path/to/config.json \
  --allowedTools "mcp__marketplace__*"

The 12 tools

Las 12 herramientas

Every tool is prefixed mcp__marketplace__ when exposed to the agent. They map 1:1 to the marketplace REST API and return trimmed JSON. Grouped here in lifecycle order.

Cada herramienta lleva el prefijo mcp__marketplace__ cuando se expone al agente. Corresponden 1:1 a la API REST del marketplace y devuelven JSON reducido. Aquí van agrupadas en orden de ciclo de vida.

Discovery

Descubrimiento

Contracting

Contratación

Fulfillment

Cumplimiento

Verification & settlement

Verificación y liquidación

Reputation

Reputación

A typical session

Una sesión típica

The tools are meant to be called in lifecycle order. A full purchase looks like this:

Las herramientas están pensadas para llamarse en orden de ciclo de vida. Una compra completa se ve así:

# 1. Discover a suitable vetted provider
search_offers({ query: "Costa Rica company hotel", category: "legal" })
get_offer({ offer_id: 7 })            # review steps, escrow terms, provider profile

# 2. Contract and fund
create_engagement({ offer_id: 7 })      # draft → returns engagement_id, e.g. 12
agree_to_contract({ engagement_id: 12 })  # draft → agreed (steps now immutable)
fund_escrow({ engagement_id: 12 })        # moves the downpayment into escrow

# 3. Wait for the provider to deliver
wait_for_provider_submission({ engagement_id: 12, timeout_seconds: 120 })

# 4. Verify EVERY registry-anchored proof before releasing money
verify_registry_reference({ ref: "CR-RN-2026-104512" })   # company registry
verify_registry_reference({ ref: "CR-MUNI-2026-77310" })   # municipal permit

# 5. Settle - only if all proofs check out
approve_and_release_payment({ engagement_id: 12 })  # releases the full price
rate_provider({ engagement_id: 12, value: "good" })

Errors

Errores

When the marketplace rejects a call, the tool returns an MCP error result (isError) whose text carries the HTTP status and message from the marketplace - for example 409 when a state transition is illegal (funding an engagement that is not yet agreed), or 404 for an unknown registry reference. Read the message, correct the request, and retry.

Cuando el marketplace rechaza una llamada, la herramienta devuelve un resultado de error MCP (isError) cuyo texto lleva el estado HTTP y el mensaje del marketplace - por ejemplo 409 cuando una transición de estado es inválida (financiar un contrato que aún no está acordado), o 404 para una referencia de registro desconocida. Lee el mensaje, corrige la solicitud y reintenta.