Agents
Waypath is the customer memory layer for AI agents. One read primitive, three write primitives. REST + MCP.
Most agent code looks the same: pull customer state, take an action, write what happened back. Waypath is the API on either side of that loop. Your agent never has to crawl five SaaS tools to figure out who it is talking to.
The four primitives
| Verb | Endpoint | Purpose | P50 |
|---|---|---|---|
| GET | /v1/context/:id or /v1/context?email= | Token-budgeted customer state. | 120ms |
| GET | /v1/account/:id | B2B account roll-up. Contacts, opps, blockers, trajectory. | 180ms |
| POST | /v1/memory | Typed write. decision, action, or observation. Idempotent. | 60ms |
| POST | /v1/events | Marketing event ingest. Identity resolves email then phone then externalId. | 80ms |
Two ways in
MCP. One command and Claude Desktop can call all four primitives:
claude mcp add --transport http waypath https://mcp.waypath.app -s userREST. Same surface, any language. Send X-API-Key: wp_live_... and
hit https://api.waypath.app.
What the agent sees
{
"customer": "Jane Doe . Acme (250-1000)",
"customer_id": "cus_8af2",
"lifecycle_stage": "opportunity",
"sentiment_trajectory": { "30d": "declining", "trigger": "support_ticket_unresolved" },
"intent_signals": ["viewed_pricing_3x", "downloaded_whitepaper"],
"open_loops": ["awaiting_security_review"],
"blockers": ["procurement_review_q2"],
"recent_decisions": [
{ "agent": "support_v2", "action": "escalate_to_human", "outcome": "ticket_resolved", "ts": "2026-04-12T14:22:11Z" }
]
}That is one HTTP call. The same payload comes back through MCP via
get_customer_context({ email }).
Where to start
- Quickstart. 90 seconds from zero to a customer-context call.
- API Keys. Issue, scope, rotate.
- Customer Context. The read primitive.
- Memory Writes. The decision/action/observation ledger.
- Account Brief. The B2B roll-up.
- Events. Single + batch ingest.
- MCP Setup. Claude Desktop, Cursor, ChatGPT.
- CLI. The
wpbinary.
Internal agent ecosystem
The same primitives back Waypath’s own multi-buddy system, an orchestrator plus four specialists that drive the dashboard.
- Orchestrator and Buddies. Personas, tool allowlists, delegation flow.
- Playbooks. Executable agent specs.
- BYOK. Per-buddy model routing (Metered, Claude, OpenAI).