Fielded Reps MCP server and API

Prices

Extra miles $1.50 · waiting $0.60/min after 10 min · nights and weekends +25% · declared value over $500 adds 1%.

MCP (start here)

Streamable HTTP endpoint https://joinfielded.com/api/mcp. Clients sign in with OAuth (dynamic client registration and PKCE, discovered from /.well-known/oauth-authorization-server), or send Authorization: Bearer frk_…. Tools: get_service_info, quote_task, book_task, get_status, list_tasks, get_proof, cancel_task, rate_task, report_issue. Connect your agent.

Bookings above your key's approval amount wait for a person on your team to approve by text link. Every key has a monthly spending cap.

REST

# Quote
curl -X POST https://joinfielded.com/api/v1/quotes \
  -H "Authorization: Bearer frk_your_key" -H "content-type: application/json" \
  -d '{"kind":"same_day_run","stops":[
        {"kind":"pickup","address":"2001 Landmeier Rd, Elk Grove Village, IL"},
        {"kind":"dropoff","address":"600 W Fulton St, Chicago, IL","contactName":"Sam"}],
       "itemDesc":"3 sealed boxes","recipientPhone":"+13125550123"}'

# Book (pass the quoted task_id, or the same body to quote and book at once)
curl -X POST https://joinfielded.com/api/v1/tasks -H "Authorization: Bearer frk_your_key" \
  -H "content-type: application/json" -d '{"task_id":"tsk_..."}'

# Status, proof, cancel
curl https://joinfielded.com/api/v1/tasks/tsk_... -H "Authorization: Bearer frk_your_key"
curl https://joinfielded.com/api/v1/tasks/tsk_.../proof -H "Authorization: Bearer frk_your_key"
curl -X POST https://joinfielded.com/api/v1/tasks/tsk_.../cancel -H "Authorization: Bearer frk_your_key"

Outcomes: booked, assigned, awaiting_approval, payment_pending, in_review or rejected. Webhooks (optional) send task.booked, task.assigned, task.started, task.picked_up, task.delivered, task.completed and task.cancelled.

What reps won't do

Carry alcohol, prescriptions, cannabis, weapons, hazardous materials, medical specimens or more than $500 cash; do licensed work (process serving, moving, trades); sign contracts or accept legal papers for you; or claim to be your own employee.