Pingpoint

@suverselabs/pingpoint-mcp

MCP server that gives an AI agent a live truck GPS position: create a freight load, PingPoint texts the driver an app link (onboarding takes about a minute — no ELD provider, no corporate account, no annual contract), then read live position, GPS track, stop timeline and ETA, and cancel a load you no longer need.

No account yet? A sandbox key is published at https://pingpoint.suverse.io/docs/#sandbox: same endpoints, no signup, and the load drives itself through the full cycle in about 20 minutes. Or skip keys entirely and pay per call with USDC from a wallet on Arc, Base or Solana.

Install

Claude Code, one line:

claude mcp add pingpoint --env PINGPOINT_AGENT_KEY=sup_agent_… -- npx -y @suverselabs/pingpoint-mcp

Or add to your MCP config (Claude Desktop: claude_desktop_config.json; Claude Code: .mcp.json; any MCP-capable agent works the same way):

{

"mcpServers": { "pingpoint": { "command": "npx", "args": ["-y", "@suverselabs/pingpoint-mcp"], "env": { "PINGPOINT_AGENT_KEY": "sup_agent_…" } } } }

Restart the agent and the tools appear.

Hosted endpoint (no install)

Clients that speak MCP Streamable HTTP can connect straight to

https://pingpoint.suverse.io/mcp

Authorization: Bearer sup_agent_…

Claude Code: claude mcp add --transport http pingpoint https://pingpoint.suverse.io/mcp --header "Authorization: Bearer sup_agent_…".

The server is stateless and keeps no credentials: each request runs with the key it carries. Listing tools works without a key; calling one without it answers HTTP 401. Same tools, same prices. Wallet mode (pay per call with USDC) is available only when you run the package yourself.

Tools

Why `update_load_status` answers 501. PingPoint drives load statuses itself, from driver GPS and geofence events, so external status writes don't exist. Treat that as a data-integrity guarantee: a status you read was never hand-set by anyone; it is backed by actually recorded position. The tool is kept only so an agent that tries it gets a clear answer instead of a mystery. Delivery confirmation is likewise not a vendor operation — it belongs to the carrier flow, where the carrier files the BOL over Telegram.

Stops. A load carries 1–2 pickups and 1–3 deliveries; array order is the stop sequence. Each stop takes an optional window: date (start) and dateTo (end). onTime is measured against the dateTo of the last delivery, so without it that field stays null. Stops are fixed at creation — there is no add-stop tool.

Required to create a load: driverPhone (E.164 — the driver app link is sent to that number) plus pickups and deliveries arrays; every stop needs address, city, state, zip. Everything else is optional. customerRef doubles as a dedup key; pass the same idempotencyKey on retries so the balance is charged at most once.

Example — "where is my load?"

get_load_position with { "loadNumber": "LD-2026-042317" } returns:

{

"loadNumber": "LD-2026-042317", "pingpointLoadId": "6f1c2d3e-8a45-4b9c-9d10-2e5f7a8b9c01", "status": "IN_TRANSIT", "createdAt": "2026-08-18T14:02:11.000Z", "deliveredAt": null, "driverTracking": "REPORTING", "inviteSentAt": "2026-08-18T14:02:12.000Z", "linkOpenedAt": null, "declinedAt": null, "distanceMiles": 412.7, "onTime": null, "delayMinutes": null, "pickupDwellMinutes": 38, "deliveryDwellMinutes": null, "stops": [ { "type": "PICKUP", "sequence": 1, "city": "Claremore", "state": "OK", "windowFrom": "2026-08-18T15:00:00.000Z", "windowTo": "2026-08-18T19:00:00.000Z", "arrivedAt": "2026-08-18T15:47:31.000Z", "departedAt": "2026-08-18T16:25:09.000Z" }, { "type": "DELIVERY", "sequence": 2, "city": "Charlotte", "state": "NC", "windowFrom": "2026-08-20T12:00:00.000Z", "windowTo": "2026-08-20T16:00:00.000Z", "arrivedAt": null, "departedAt": null } ], "gpsTrack": [ { "lat": 36.3126, "lng": -95.6161, "speed": null, "heading": null, "ts": "2026-08-18T16:25:09.000Z" }, { "lat": 35.4676, "lng": -94.3579, "speed": null, "heading": null, "ts": "2026-08-18T18:55:42.000Z" } ], "pingCount": 214, "eta": { "nextStop": { "type": "DELIVERY", "sequence": 2, "city": "Charlotte", "state": "NC" }, "receivingWindow": { "from": "2026-08-20T12:00:00.000Z", "to": "2026-08-20T16:00:00.000Z" }, "distanceToNextStopMi": 611.4, "driveTimeHours": 11.2, "moving": true, "stoppedForMinutes": null, "etaWindow": { "from": "2026-08-20T13:05:00.000Z", "to": "2026-08-20T15:40:00.000Z" }, "tracking": { "state": "pinging", "noDataForMinutes": null }, "reason": null } }

(gpsTrack shortened here; the API returns up to the last 500 points.)

Example — "how did the trip go?"

get_load_position answers "where is the truck now"; get_trip_stats answers "how did the finished trip go". On a DELIVERED load, get_trip_stats with { "loadNumber": "LD-2026-648319" } returns:

{

"loadNumber": "LD-2026-648319", "loadId": "927741bc-dfd0-41ba-9e99-5c5031c756f9", "stats": { "dataPoints": 4785, "durationSeconds": 69329, "estimatedDistanceMiles": 486.591, "avgSpeedMph": 25.27, "maxSpeedMph": 88.22, "hardAccelCount": 280, "hardBrakeCount": 168, "cityMilesPct": 9.96, "highwayMilesPct": 88.65, "parkedTimePct": 53.65, "nightPct": 44.7, "coveragePct": 100, "firstAt": "2026-08-18T16:53:25.000Z", "lastAt": "2026-08-19T12:08:54.000Z" } }

Distances are miles, speeds are mph, percentages are 0–100, timestamps are UTC.

Is the driver actually sharing?

driverTracking in the get_load_position answer is the same word the PingPoint cabinet shows, so the agent can explain a silent load without guessing from an empty track:

null means the load has no driver yet.

Webhooks

Push notifications (pingpoint.load.created, pingpoint.load.updated, pingpoint.status.changed, pingpoint.load.completed, pingpoint.exception.raised, pingpoint.exception.resolved — the last two for LATE / NO_SIGNAL / LONG_DWELL) are configured in the cabinet, not through MCP tools: https://pingpoint.suverse.io/docs/webhooks

Pay per call with USDC

No account, no key: point the server at a wallet and every paid tool call is settled from it in USDC over x402 (HTTP 402 + a signed USDC transfer). PingPoint's relayer submits the transfer and pays the gas; the server only signs. Pick the chain with PINGPOINT_NETWORK:

# EVM (Arc testnet / Base)

echo "0x<64 hex private key>" > ~/.pingpoint-wallet.key && chmod 600 ~/.pingpoint-wallet.key claude mcp add pingpoint --env PINGPOINT_WALLET_KEY_FILE=$HOME/.pingpoint-wallet.key --env PINGPOINT_NETWORK=base-mainnet -- npx -y @suverselabs/pingpoint-mcp

Solana

solana-keygen new --outfile ~/.pingpoint-wallet.json # or point at an existing keypair file claude mcp add pingpoint --env PINGPOINT_WALLET_KEY_FILE=$HOME/.pingpoint-wallet.json --env PINGPOINT_NETWORK=solana-mainnet -- npx -y @suverselabs/pingpoint-mcp

{

"mcpServers": { "pingpoint": { "command": "npx", "args": ["-y", "@suverselabs/pingpoint-mcp"], "env": { "PINGPOINT_WALLET_KEY_FILE": "/home/me/.pingpoint-wallet.json", "PINGPOINT_NETWORK": "solana-mainnet", "PINGPOINT_RPC_URL": "https:// " } } } }

Fund the wallet with USDC on that network (ask get_balance — it returns the address and the balance), then use the tools as usual. On Solana the wallet needs no SOL: PingPoint's relayer is the transaction fee payer. Paid results carry a payment block with the transaction hash (EVM) or signature (Solana) and an explorer link:

{ "loadNumber": "LD-2026-111417", "trackingLink": "https://pingpoint.suverse.io/track/…",

"payment": { "transaction": "0x97f738e3…", "network": "base-mainnet", "payer": "0xE958…dB2E", "amountUsdc": "0.65", "explorerUrl": "https://basescan.org/tx/0x97f738e3…" } }

A refused call (403, 404, 429, invalid input, PaymentFailed INSUFFICIENT_BALANCE, 503 X402_RELAYER_LOW_GAS) costs nothing: ownership, limits, balance and the relayer's gas are checked before settlement. EVM offers live 300 s with a one-time nonce per signature; a Solana transaction lives as long as its blockhash (about a minute). The SDK refuses offers above 1 USDC or on another asset or network before signing. Keep the key file private (chmod 600) — a wallet holding just enough USDC for the day is the sensible setup. Public RPC endpoints (Base, Solana) rate-limit; set PINGPOINT_RPC_URL to your provider for steady use.

Getting a key

1. Sign up at pingpoint.suverse.io (e-mail or Google/GitHub).
2. In the cabinet open **Integration