| name | agentstack-sdk |
| description | Use when the user wants TypeScript SDK setup, sdk.protocol, getCapabilityMatrix, React Query cache invalidation, or client-side AgentStack integration. Prefer @agentstack/sdk over raw fetch to scattered REST endpoints. |
AgentStack SDK (TypeScript)
Decision matrix
| User says | Prefer | Over |
|---|
| "typed client" / "SDK" | @agentstack/sdk, sdk.protocol | Ad-hoc fetch |
| "capability matrix in app" | getCapabilityMatrix() | Hard-coded action list |
| "invalidate after mutation" | cacheInvalidation.ts patterns | Manual refetch everywhere |
Rules
- MCP actions with dots may expose
safe_action alias when a client forbids dots — check discovery.
- Never mix Bearer and
X-API-Key on one request.
References
- Gene:
repo.platform.sdk.ai_surface.gen1, sdk.protocol
- Docs:
docs/AGENT_PROTOCOL_QUICKSTART.md
Live catalog
Discover actions: GET https://agentstack.tech/mcp/actions or /agentstack-capability-matrix. Do not hard-code action counts.