Tradehand

영국에서 지역 장인을 찾아보고 예약하세요. 프로필과 서비스를 확인하고, 견적이나 예약 검토를 준비한 후 Tradehand에서 확정하세요.

호스팅형 MCP 서버

npx add-mcp 'https://tradehand.com/api/mcp'

Claude Code, Codex, Cursor 등에 설치됩니다

문서

Quickstart

Check the versioned REST API:

curl https://tradehand.com/api/v1/status

Read a public page as markdown:

curl -H "Accept: text/markdown" https://tradehand.com/pricing

Initialize the MCP Streamable HTTP transport:

curl https://tradehand.com/api/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  --data '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"example","version":"1.0"}}}'

Search for electricians near a UK postcode:

curl https://tradehand.com/api/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  --data '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"search_traders","arguments":{"trade":"Electricians","postcode":"CO1 1AA","limit":10}}}'

Documentation and schemas

Tradehand OpenAPI 3.1 specification /.well-known/openapi.json Tradehand API catalog /.well-known/api-catalog Tradehand MCP server card /.well-known/mcp/server-card.json Tradehand agent skills /.well-known/agent-skills/index.json Tradehand llms.txt /llms.txt

Access, API keys, and environments

The public read API and MCP discovery tools require no API key and are free to call.

The production endpoint is safe for examples because these public operations cannot write data.

Tradehand does not currently expose private business operations or a public write sandbox.

Versioning and deprecation

REST endpoints use a major version in the URL, beginning with /api/v1. Breaking changes move to a new major version. A deprecated version remains available for at least 180 days and returns Deprecation, Sunset, and a successor-version link before removal.

The legacy /api/markdown route sunsets on 22 February 2027; use /api/v1/pages/markdown for new integrations.

Rate limits

Each public REST runtime allows 60 requests per 60 seconds per client address. Responses return structured RateLimit and RateLimit-Policy fields under the tradehand-public policy; HTTP 429 also returns Retry-After.

Errors

REST errors use RFC 9457 application/problem+json with type, title, status, detail, and instance. Tradehand adds a stable code and a resolution hint. MCP errors remain JSON-RPC 2.0 errors as the MCP protocol requires.

Get on with the work.

Spend less time on admin and more on the work you love.

Get started