@agentstate/sdk

TypeScript SDK for AgentState — conversation history for AI agents

Add to Cursor Add to VS Code Run on PlugMCPClaim this server

Add to Cursor Add to VS Code Run on PlugMCP

1{2  "mcpServers": {3    "agentstate-sdk": {4      "command": "npx",5      "args": [6        "-y",7        "@agentstate/[email protected]"8      ]9    }10  }11}

.cursor/mcp.jsonMCP server

Transport: stdio
Status: Local

Power your agent

Add this server

The publisher's own command. Not a PlugMCP endpoint.

Add to Cursor Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Local command

npx -y @agentstate/[email protected]

Claude Code has no install link for a local command. Copy the command below and run it in a terminal.

shClaude Code

1claude mcp add agentstate-sdk -- npx -y @agentstate/sdk@0.1.4

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "agentstate-sdk": {4      "command": "npx",5      "args": [6        "-y",7        "@agentstate/[email protected]"8      ]9    }10  }11}

claude_desktop_config.json

Local · npmPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Local

Transport: stdio
Version: 0.1.4
Last checked: 2026-11-14

Stars: —
Tools: —
Uptime: —

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

How do I install @agentstate/sdk?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does @agentstate/sdk need an API key?

No required environment variable is listed on this record.

What transport does @agentstate/sdk use?

@agentstate/sdk runs locally over stdio.

When was @agentstate/sdk last checked?

Last checked 2026-11-14. TypeScript SDK for AgentState — conversation history for AI agents

From the publisher

Documentation

AgentState

Open source (MIT), self-host anytime, free to start — no credit card.

State and coordination layer for AI agent fleets.

You're building AI agents — not a distributed systems backend. Stop reinventing state management, locking, delegation, and history storage. Just call an API.

AgentState gives agent fleets five primitives — everything needed to coordinate work, track decisions, and share state across many concurrent agents.

Built for vibe coders. No SDK needed — give your coding agent the API docs and let it wire things up. Or use the REST API directly with any language, any framework.

Features

Five primitives

States — Versioned key/value state with an append-only event log; query across all agents in a fleet
Leases — Distributed locks for exactly-one-writer coordination across N concurrent agents (recipe)
Claims — Verifiable assertions with attached evidence you can audit later (recipe)
Capability Tokens — Scoped, revocable delegation so sub-agents get only the access they need (recipe)
Conversations — Full message history with CRUD, search, tags, bulk export, and AI-generated titles

Supporting capabilities

API Key Auth — SHA-256 hashed keys with project scoping
AI-Powered — Auto-generate titles and follow-up questions
Cursor Pagination — Efficient, stable pagination for large datasets
Bulk Export — Export conversations with messages in one call
External ID Lookup — Map your own IDs to AgentState conversations
Full-Text Search — Search across message content with snippets
Tags — Organize conversations with tags and filter by tag
Bulk Operations — Bulk delete and export conversations
Request Tracing — X-Request-Id header on every response
Webhooks — HMAC-signed delivery for conversation.created events — see docs/webhooks.md
MCP Server — Remote (/api/mcp, OAuth 2.1) and local stdio (@agentstate/mcp) Model Context Protocol servers for Cursor, Claude Desktop, and Windsurf — see docs/mcp.md

Quick Start

npm install @agentstate/sdk

import { AgentState } from "@agentstate/sdk";

const client = new AgentState({ apiKey: "as_live_..." });
const conv = await client.createConversation({
  messages: [{ role: "user", content: "Hello" }],
});

Or use the REST API directly:

# Create a conversation
curl -X POST https://agentstate.app/api/v1/conversations \
  -H "Authorization: Bearer as_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "messages": [
      {"role": "user", "content": "Hello!"},
      {"role": "assistant", "content": "Hi! How can I help?"}
    ]
  }'

# Retrieve it (replace $CONVERSATION_ID with the id from the response above)
curl https://agentstate.app/api/v1/conversations/$CONVERSATION_ID \
  -H "Authorization: Bearer as_live_your_key"

API Endpoints

All endpoints are served under /api/v1/. See the API Reference for full details.

Method	Path	Description
POST	`/api/v1/conversations`	Create conversation
GET	`/api/v1/conversations`	List conversations (cursor pagination)
GET	`/api/v1/conversations/:id`	Get conversation (includes messages by default; `?fields=!messages` to exclude)
PUT	`/api/v1/conversations/:id`	Update title/metadata
DELETE	`/api/v1/conversations/:id`	Delete with messages
POST	`/api/v1/conversations/:id/messages`	Append messages
GET	`/api/v1/conversations/:id/messages`	List messages
POST	`/api/v1/conversations/:id/generate-title`	AI title generation
POST	`/api/v1/conversations/:id/follow-ups`	AI follow-up questions
GET	`/api/v1/conversations/search`	Full-text search
POST	`/api/v1/conversations/export`	Bulk export with messages
GET	`/api/v1/tags`	List project tags
POST	`/api/v1/conversations/:id/tags`	Add tags
DELETE	`/api/v1/conversations/:id/tags/:tag`	Remove tag
GET	`/api/v1/analytics/summary`	Usage summary
GET	`/api/v1/analytics/timeseries`	Time series data
GET	`/api/v1/analytics/tags`	Tag statistics
PUT	`/api/v1/states/:stateKey`	Create or replace state
GET	`/api/v1/states/:stateKey`	Read state
POST	`/api/v1/states/query`	Query states
DELETE	`/api/v1/states/:stateKey`	Delete state
GET	`/api/v1/states/:stateKey/events`	List state events
POST	`/api/v1/states/:stateKey/lease`	Create lease
POST	`/api/v1/leases/:id/renew`	Renew lease
DELETE	`/api/v1/leases/:id`	Release lease
POST	`/api/v1/capability-tokens`	Create capability token
GET	`/api/v1/capability-tokens`	List capability tokens
DELETE	`/api/v1/capability-tokens/:id`	Revoke capability token
POST	`/api/v1/claims`	Create claim
GET	`/api/v1/claims`	List claims
GET	`/api/v1/claims/:id`	Get claim with evidence
POST	`/api/v1/claims/:id/verify`	Verify claim

Tech Stack

Runtime: Cloudflare Workers (single Worker)
Database: Cloudflare D1 (SQLite at edge)
API Framework: Hono
ORM: Drizzle ORM
Dashboard: Astro + React islands + Clerk + Tailwind v4
Package Manager: Bun
Linter: Biome
Tests: Vitest

Development

bun install

# API (port 8787)
cd packages/api && bunx wrangler dev

# Dashboard (port 4321, separate dev server)
cd packages/dashboard && bun run dev

See CLAUDE.md for full dev commands and conventions.

Documentation

Guide	Description
Documentation Index	Complete docs index
Getting Started	Zero to working in 2 minutes
API Reference	Complete REST API documentation
V2 Migration Guide	Migrate from V1 to V2 API
TypeScript SDK	SDK installation, methods, and examples
Python SDK	Python package for AgentState
Framework Integration	Vercel AI SDK, Cloudflare Workers AI, LangGraph
Environment Variables	All env vars and Cloudflare bindings
Core Memory	Durable maintenance notes for future agents
Roadmap	What's shipped, what's next, and how to influence direction
Contributing	How to contribute, branch conventions, and PR template

See CLAUDE.md for development guide and conventions.

License

MIT

@agentstate/sdk

GitHub ActionsClaim this server

TypeScript SDK for AgentState — conversation history for AI agents

Developer Tools Devops

Add to Cursor Add to VS Code Run on PlugMCPClaim this server

GitHub npm Website

Add to Cursor Add to VS Code Run on PlugMCP

1{2  "mcpServers": {3    "agentstate-sdk": {4      "command": "npx",5      "args": [6        "-y",7        "@agentstate/[email protected]"8      ]9    }10  }11}

.cursor/mcp.jsonMCP server

Transport: stdio
Status: Local

Power your agent

Add this server

The publisher's own command. Not a PlugMCP endpoint.

Add to Cursor Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Local command

npx -y @agentstate/[email protected]

Claude Code has no install link for a local command. Copy the command below and run it in a terminal.

shClaude Code

1claude mcp add agentstate-sdk -- npx -y @agentstate/sdk@0.1.4

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "agentstate-sdk": {4      "command": "npx",5      "args": [6        "-y",7        "@agentstate/[email protected]"8      ]9    }10  }11}

claude_desktop_config.json

Local · npmPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Local

Transport: stdio
Version: 0.1.4
Last checked: 2026-11-14

Stars: —
Tools: —
Uptime: —

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

How do I install @agentstate/sdk?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does @agentstate/sdk need an API key?

No required environment variable is listed on this record.

What transport does @agentstate/sdk use?

@agentstate/sdk runs locally over stdio.

When was @agentstate/sdk last checked?

Last checked 2026-11-14. TypeScript SDK for AgentState — conversation history for AI agents

From the publisher

Documentation

AgentState

Open source (MIT), self-host anytime, free to start — no credit card.

State and coordination layer for AI agent fleets.

You're building AI agents — not a distributed systems backend. Stop reinventing state management, locking, delegation, and history storage. Just call an API.

AgentState gives agent fleets five primitives — everything needed to coordinate work, track decisions, and share state across many concurrent agents.

Built for vibe coders. No SDK needed — give your coding agent the API docs and let it wire things up. Or use the REST API directly with any language, any framework.

Features

Five primitives

States — Versioned key/value state with an append-only event log; query across all agents in a fleet
Leases — Distributed locks for exactly-one-writer coordination across N concurrent agents (recipe)
Claims — Verifiable assertions with attached evidence you can audit later (recipe)
Capability Tokens — Scoped, revocable delegation so sub-agents get only the access they need (recipe)
Conversations — Full message history with CRUD, search, tags, bulk export, and AI-generated titles

Supporting capabilities

API Key Auth — SHA-256 hashed keys with project scoping
AI-Powered — Auto-generate titles and follow-up questions
Cursor Pagination — Efficient, stable pagination for large datasets
Bulk Export — Export conversations with messages in one call
External ID Lookup — Map your own IDs to AgentState conversations
Full-Text Search — Search across message content with snippets
Tags — Organize conversations with tags and filter by tag
Bulk Operations — Bulk delete and export conversations
Request Tracing — X-Request-Id header on every response
Webhooks — HMAC-signed delivery for conversation.created events — see docs/webhooks.md
MCP Server — Remote (/api/mcp, OAuth 2.1) and local stdio (@agentstate/mcp) Model Context Protocol servers for Cursor, Claude Desktop, and Windsurf — see docs/mcp.md

Quick Start

npm install @agentstate/sdk

import { AgentState } from "@agentstate/sdk";

const client = new AgentState({ apiKey: "as_live_..." });
const conv = await client.createConversation({
  messages: [{ role: "user", content: "Hello" }],
});

Or use the REST API directly:

# Create a conversation
curl -X POST https://agentstate.app/api/v1/conversations \
  -H "Authorization: Bearer as_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "messages": [
      {"role": "user", "content": "Hello!"},
      {"role": "assistant", "content": "Hi! How can I help?"}
    ]
  }'

# Retrieve it (replace $CONVERSATION_ID with the id from the response above)
curl https://agentstate.app/api/v1/conversations/$CONVERSATION_ID \
  -H "Authorization: Bearer as_live_your_key"

API Endpoints

All endpoints are served under /api/v1/. See the API Reference for full details.

Method	Path	Description
POST	`/api/v1/conversations`	Create conversation
GET	`/api/v1/conversations`	List conversations (cursor pagination)
GET	`/api/v1/conversations/:id`	Get conversation (includes messages by default; `?fields=!messages` to exclude)
PUT	`/api/v1/conversations/:id`	Update title/metadata
DELETE	`/api/v1/conversations/:id`	Delete with messages
POST	`/api/v1/conversations/:id/messages`	Append messages
GET	`/api/v1/conversations/:id/messages`	List messages
POST	`/api/v1/conversations/:id/generate-title`	AI title generation
POST	`/api/v1/conversations/:id/follow-ups`	AI follow-up questions
GET	`/api/v1/conversations/search`	Full-text search
POST	`/api/v1/conversations/export`	Bulk export with messages
GET	`/api/v1/tags`	List project tags
POST	`/api/v1/conversations/:id/tags`	Add tags
DELETE	`/api/v1/conversations/:id/tags/:tag`	Remove tag
GET	`/api/v1/analytics/summary`	Usage summary
GET	`/api/v1/analytics/timeseries`	Time series data
GET	`/api/v1/analytics/tags`	Tag statistics
PUT	`/api/v1/states/:stateKey`	Create or replace state
GET	`/api/v1/states/:stateKey`	Read state
POST	`/api/v1/states/query`	Query states
DELETE	`/api/v1/states/:stateKey`	Delete state
GET	`/api/v1/states/:stateKey/events`	List state events
POST	`/api/v1/states/:stateKey/lease`	Create lease
POST	`/api/v1/leases/:id/renew`	Renew lease
DELETE	`/api/v1/leases/:id`	Release lease
POST	`/api/v1/capability-tokens`	Create capability token
GET	`/api/v1/capability-tokens`	List capability tokens
DELETE	`/api/v1/capability-tokens/:id`	Revoke capability token
POST	`/api/v1/claims`	Create claim
GET	`/api/v1/claims`	List claims
GET	`/api/v1/claims/:id`	Get claim with evidence
POST	`/api/v1/claims/:id/verify`	Verify claim

Tech Stack

Runtime: Cloudflare Workers (single Worker)
Database: Cloudflare D1 (SQLite at edge)
API Framework: Hono
ORM: Drizzle ORM
Dashboard: Astro + React islands + Clerk + Tailwind v4
Package Manager: Bun
Linter: Biome
Tests: Vitest

Development

bun install

# API (port 8787)
cd packages/api && bunx wrangler dev

# Dashboard (port 4321, separate dev server)
cd packages/dashboard && bun run dev

See CLAUDE.md for full dev commands and conventions.

Documentation

Guide	Description
Documentation Index	Complete docs index
Getting Started	Zero to working in 2 minutes
API Reference	Complete REST API documentation
V2 Migration Guide	Migrate from V1 to V2 API
TypeScript SDK	SDK installation, methods, and examples
Python SDK	Python package for AgentState
Framework Integration	Vercel AI SDK, Cloudflare Workers AI, LangGraph
Environment Variables	All env vars and Cloudflare bindings
Core Memory	Durable maintenance notes for future agents
Roadmap	What's shipped, what's next, and how to influence direction
Contributing	How to contribute, branch conventions, and PR template

See CLAUDE.md for development guide and conventions.

License

MIT