MCP server

Give your AI agent physical arms.

Fielded Reps is an MCP server. Attach it to Claude, ChatGPT, Cursor or your own agent and it can send a background-checked person, wearing your brand, to pick up, drop off, hand-deliver or staff a table anywhere in the Chicago core and northwest suburbs, then hand back GPS-verified proof.

Beta: agents can connect, quote and book today. Bookings are held and no rep is dispatched until insurance coverage is bound.

Server URL

https://joinfielded.com/api/mcp

Streamable HTTP. Sign-in is OAuth with dynamic client registration, so most clients only need the URL: they open a Fielded page where you sign in (or create a client account) and set the connection's monthly limit and approval amount.

Claude (web, desktop, mobile)

  1. Open Settings, then Connectors, and add a custom connector.
  2. Paste the server URL and connect.
  3. Sign in to Fielded, set limits, choose Allow.

Claude Code

claude mcp add --transport http fielded-reps https://joinfielded.com/api/mcp

Then run /mcp in Claude Code to sign in.

ChatGPT

With developer mode on, create a connector, paste the server URL and choose OAuth. ChatGPT registers itself and sends you to the Fielded sign-in page.

Cursor, VS Code and other clients

{
  "mcpServers": {
    "fielded-reps": { "url": "https://joinfielded.com/api/mcp" }
  }
}

Headless agents and servers

No browser to sign in with? Create an API key in Reps settings and send it on every request. Keys carry the same limits as OAuth connections.

{
  "mcpServers": {
    "fielded-reps": {
      "type": "http",
      "url": "https://joinfielded.com/api/mcp",
      "headers": { "Authorization": "Bearer frk_your_key" }
    }
  }
}

Prefer plain HTTP? The same actions are in the REST API.

Tools

get_service_infoService, prices and account limits. Call this first. Returns what Fielded Reps does, the service area, prices, what reps won't carry or do, cancellation terms, and this connection's limits: monthly spending cap, amount used this month, and the per-booking approval threshold. Also says whether live dispatch is on.read-only
quote_taskQuote a task. Price a physical task done by a vetted, background-checked Fielded rep wearing your brand (Chicago core and northwest suburbs). Describe it in `request` and/or give structured fields. Returns a quote and a task_id to pass to book_task. Nothing is booked or charged.read-only
book_taskBook a rep. Book a rep. Pass task_id from quote_task (preferred: confirm the quote with the user first), or the same fields as quote_task to quote and book in one step. Spends money on the client's account. Bookings over the approval threshold return outcome awaiting_approval with an approval_url to show the user.
get_statusTask status. Current status of a task (draft, review, awaiting_approval, booked, assigned, in_progress, completed, cancelled) with stop-by-stop progress and a public tracking link.read-only
list_tasksList tasks. Recent tasks on this account, newest first, optionally filtered by status.read-only
get_proofProof of delivery. Proof packet for a task: GPS-verified check-ins per stop, timestamps, photo URLs and the recipient's name.read-only
cancel_taskCancel a task. Cancel a task. Free until a rep is assigned; 50% inside 60 minutes of the window once assigned; full price after pickup. Confirm with the user before cancelling an assigned task.
rate_taskRate the rep. Rate the rep 1-5 after a task is completed. Rating again replaces the earlier rating.
report_issueReport a problem. Report damage, a lost item, a late arrival or a conduct problem on a task. Fielded ops follows up with the account owner.

Guardrails

  • Every connection has a monthly spending cap you set.
  • Bookings over your approval amount wait for a person to approve by text link; the agent gets the same link to show you.
  • Tasks are screened before booking: no alcohol, prescriptions, cannabis, weapons, hazardous materials, medical specimens or cash over $500, no signing contracts.
  • Revoke any connection in Reps settings; it stops working at once.

Try asking your agent

“Have a Fielded rep pick up the two sample boxes at 2001 Landmeier Rd, Elk Grove Village tomorrow morning and deliver them to 600 W Fulton St, Chicago by noon. Quote it first.”

Prices: runs from $29, same-day $55, rush $79, on-site reps $59 an hour.