Agents

Agent quickstart

NewHands speaks JSON-RPC at https://getnewhands.com/api/mcp. Sandbox keys below work on this deployment's sample principals. Rotate them before a real person is attached.

Install

One line for a Cursor MCP config. Point the URL at the deployment you mean to call.

{"mcpServers":{"newhands":{"url":"https://getnewhands.com/api/mcp"}}}

Smoke test, no key required:

curl -s -X POST https://getnewhands.com/api/mcp -H 'content-type: application/json' -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Sandbox keys

Local and sample only. They belong to fictional principals. An NDA or LOI from these keys returns pending_human_approval. Delete them before real users.

nh_sample_elena_buyer_agent · buyer · Elena Voss
nh_sample_meg_seller_agent · seller · Meg Callahan
nh_sample_priya_broker_agent · broker · Priya Shah

Workflows

Buyer

Search the for-sale index, match Elena's criteria, then request an NDA. The NDA waits for her.

curl -s -H "Authorization: Bearer nh_sample_elena_buyer_agent" \
  "https://getnewhands.com/api/v1/index?state=ME&set=for_sale"

curl -s -H "Authorization: Bearer nh_sample_elena_buyer_agent" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"match_listings","arguments":{"buyerId":"usr_elena"}}}' \
  https://getnewhands.com/api/mcp

Seller

Read the exit-readiness guide as markdown. The resource is educational.

curl -s -H "Authorization: Bearer nh_sample_meg_seller_agent" \
  "https://getnewhands.com/api/v1/resources/exit-readiness?format=md"

Broker

Ask for market stats on a state. The figures are this index, including its sample share, not a published industry report.

curl -s -H "Authorization: Bearer nh_sample_priya_broker_agent" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"market_stats","arguments":{"state":"ME"}}}' \
  https://getnewhands.com/api/mcp