Shipping Cost MCP Connector

Pulls Shiprocket (actual) + Delhivery (estimated proxy) shipping costs into Claude, with Yesterday / Last 7 Days / MTD / Last 30 Days rollups.

Important limitations (read first)

• Shiprocket: costs come from live order data via the documented /orders API. The exact field name for shipping charge can vary by account/plan. Before trusting numbers, run the shiprocket_raw_order_sample tool and check which field (shipping_charges, freight_charges, charges, etc.) actually holds the value on your account, then adjust CHARGE_FIELD_CANDIDATES in lib/shiprocket.js if needed.
• Delhivery: there's no public API that lists your historical shipments by date, and no API that returns actual billed amounts — only a live rate-estimate endpoint. So delhivery_cost_estimate requires you to supply the shipment list (date, origin/dest pincode, weight) — e.g. exported from your own order records — and it estimates what each shipment should cost. It will be close but not exact to the paisa, same as your own Delhivery invoice reconciliation would show.

Setup

1. Generate Shiprocket API credentials Shiprocket panel → Settings → API → Add New API User → note the email + password emailed to that address.

2. Generate Delhivery API token Delhivery One / CL Panel → Settings → API Setup → copy your static token.

3. Deploy to Vercel

   vercel deploy
   

4. Set environment variables in the Vercel project dashboard (not in code):

   • SHIPROCKET_API_EMAIL
   • SHIPROCKET_API_PASSWORD
   • DELHIVERY_API_TOKEN
   • DELHIVERY_CLIENT_NAME (your Delhivery client/company name as registered)
   • MCP_ACCESS_TOKEN (any random string you choose — this now doubles as both the query-param token for manual testing AND the OAuth access token issued to Claude, plus the HMAC signing secret for authorization codes)

5. Add the connector in Claude using the base URL — you no longer need to append ?token=... for Claude itself (it now goes through the OAuth flow below automatically), though the query-param path still works for curl/manual testing: https://<your-vercel-app>.vercel.app/api/mcp

Why there's an OAuth layer here

Claude's custom connector UI only supports OAuth (it has no field for a plain Bearer/query token), and its connection flow always attempts Dynamic Client Registration (RFC 7591) against your server before calling any tools. A plain token-only MCP server has no /register endpoint, so that step 404s and Claude shows "couldn't register with sign-in service." To work around this, this project includes a minimal, stateless OAuth 2.1 shim:

• /.well-known/oauth-authorization-server — discovery metadata
• /.well-known/oauth-protected-resource — resource-first discovery metadata
• /api/register — auto-issues a client_id, no persistence needed
• /api/authorize — auto-approves and redirects back immediately (no login screen, since this server only ever serves you)
• /api/token — verifies the authorization code (HMAC-signed, PKCE-checked) and hands back your existing MCP_ACCESS_TOKEN as the access token

Nothing here is persisted server-side; the "codes" are self-contained signed tokens, so this works fine on Vercel's stateless serverless functions.

Tools exposed

Tool	What it does
shiprocket_cost_summary	Actual Shiprocket freight cost for yesterday / last_7_days / last_30_days / mtd
shiprocket_raw_order_sample	Diagnostic — 3 raw orders, to confirm the charge field name
delhivery_cost_estimate	Estimated Delhivery cost for a shipment list you supply
combined_cost_summary	Both carriers combined into one INR total