Connect your agent

What an agent can do today

No account or API key required for any of this. A human at Upcycle Hub confirms every job before it is scheduled — nothing below dispatches a truck by itself.

• Check service area — check_service_area tells you if a ZIP code in the Sacramento region, CA is covered.
• Get a quote estimate — get_quote_estimate returns a preliminary price range from an item description. No exact pricing or booking yet.
• Find donation centers — find_donation_centers looks up nearby nonprofit drop-off locations from our live directory — for when the answer is "donate it yourself," not "donate it to us."
• Hand us a job — not yet, as an agent. POST /api/quote/guest is pending_deploy (PR #149, not merged) and will 404 today. Once live it creates a request; it does not book a truck. Today, a person can submit any of the four doors below through the website at /quote.Coming soon as an MCP tool too: submit_quote_request (same contract — pending_deploy, tracked in PR #149).

Copy-paste

curl -X POST https://myupcyclehub.com/api/quote/guest \
  -H "Content-Type: application/json" \
  -d '{
    "door": "junk_removal",
    "name": "Jane Doe",
    "email": "jane@example.com",
    "zip_code": "95816",
    "city": "Sacramento",
    "description": "Queen mattress and two boxes of books",
    "source": "my-agent"
  }'

{
  "mcpServers": {
    "upcycle-hub": {
      "manifest_url": "https://myupcyclehub.com/api/mcp/manifest",
      "invoke_url": "https://myupcyclehub.com/api/mcp/invoke",
      "transport": "http"
    }
  }
}

Look up Upcycle Hub's OpenAPI spec at https://myupcyclehub.com/openapi.json and use the check_service_area and get_quote_estimate tools before you answer.

What's coming

• Agent-callable job submission — POST /api/quote/guest and its MCP-tool form, submit_quote_request, ship with PR #149 (not merged; pending_deploy). Until then, an agent can hand a user to /quote but cannot submit on their behalf directly.
• Dedicated door pages — /junk-removal, /cleanouts, /estate-sales, and /donations are in progress on a separate, unmerged branch; all four links above point at the generic /quote form until those ship.
• Authenticated writes for agents — right now, the 5 write tools (schedule_pickup, list_my_quotes, track_job, get_diversion_report, cancel_quote) ride on a signed-in user's own OAuth token. A distinct agent identity, scoped keys, and an audit trail land with PR #146 (not merged yet).
• Tracking — job tracking exists for authenticated users today; a no-auth tracking lookup for jobs submitted via the guest endpoint is not built yet.
• Buyout and consignment — not open yet in any form, agent or human.