README

task-relay-discovery-mcp

Discovery-only MCP server for Task Relay F1–F5 paid x402 machine jobs.

Hard boundary

This server does not:

execute F1–F5 work
proxy Task Relay payment
hold wallets or private keys
call arbitrary URLs/APIs
expose tools beyond the three listed below

Tools (exactly three)

list_task_relay_jobs
find_task_relay_job
get_task_relay_job_contract

Machine flow

Agent has a machine need (example: extract plain text from a public PDF).
Agent calls find_task_relay_job with that need.
Agent receives a Task Relay paid contract (resource, price, schema, automatic next actions).
Agent (or its existing x402 buyer client) POSTs to the exact resource URL and settles x402.
Agent consumes the strict result and continues automatically.

Example

MACHINE_NEED: extract plain text from PDF for indexing
→ find_task_relay_job({ machine_need: "extract plain text from PDF for indexing" })
→ candidate F2 resource https://task-relay-production.up.railway.app/x402/pdf-text price 0.01 USDC
→ buyer client pays x402 and POSTs { "url": "https://example.org/doc.pdf" }
→ automatic next action INDEX_TEXT | INGEST_TEXT | SKIP_NO_TEXT

Run stdio (local)

npm install
npm run build
node dist/index.js

Run HTTP (remote)

npm run build
npm run start:http

POST /mcp is the streamable HTTP MCP endpoint. GET /health is status only.

Claims not made

No organic demand, market validation, reliability percentages, or “best” claims.

task-relay-discovery-mcp

README

task-relay-discovery-mcp

Hard boundary

Tools (exactly three)

Machine flow

Example

Run stdio (local)

Run HTTP (remote)

Claims not made

Recommended Servers