State KV
Scoped key-value state for agents and workflows. Supports put, get, delete, and list operations across executions. Persistence scope is configured on the workspace integration.
Tools
| Name | Description |
|---|---|
putSet a key-value pair in the store. Overwrites any existing value. | Set a key-value pair in the store. Overwrites any existing value. |
getGet a value by key from the store. | Get a value by key from the store. |
deleteDelete a key-value pair from the store. | Delete a key-value pair from the store. |
add_to_listAppend a value to an array stored at the given key. Creates the array if it does not exist. | Append a value to an array stored at the given key. Creates the array if it does not exist. |
remove_from_listRemove occurrences of a value from an array stored at the given key. | Remove occurrences of a value from an array stored at the given key. |
Quick Start
import { WeavzClient } from '@weavz-io/sdk'
const weavz = new WeavzClient({ apiKey: 'wvz_...' })
const result = await weavz.actions.execute('kv-store', 'put', {
workspaceId: '550e8400-e29b-41d4-a716-446655440000',
integrationAlias: 'kv-store',
input: { /* ... */ },
})Related Integrations
Works well with
Frequently Asked Questions
How do I connect State KV to my app?
State KV does not require an external account connection. Install the SDK, add the integration to a workspace, then execute tools programmatically.
What tools does State KV support?
State KV supports 5 tools including Put, Get, Delete, Add to List, Remove from List.
Can I use State KV with AI agents?
Yes. Add State KV to an MCP server in Tool Mode or Code Mode. Code Mode provides 3 meta-tools with on-demand API discovery so agents can compose stateful workflows without loading every action schema up front.
How do I connect State KV to ChatGPT or Claude?
Open the Weavz connector setup, sign in, choose a workspace, and add State KV as an approved app. ChatGPT, Claude, and other remote MCP clients can then call the scoped State KV tools exposed by that workspace.
Does State KV work with Claude Code, Cursor, Codex, and local agents?
Yes. Remote and local MCP clients can connect to a Weavz MCP endpoint for the workspace. Local coding agents can also use the Weavz CLI to inspect apps, discover actions, run approved State KV work, and execute Code Mode workflows from a terminal.
What can I ask an AI agent to do with State KV?
State KV exposes 5 tools, including Put, Get, Delete, Add to List, Remove from List. Use Weavz to keep credentials scoped, require approval for sensitive work, and audit what the agent did.
Can State KV be used in stateful agent workflows?
Yes. Agents can combine State KV tools with Filesystem, State KV, Human Gates, input partials, and other workspace integrations while keeping execution scoped to the selected workspace or end user.
What authentication does State KV use?
State KV does not require external authentication.
How much does the State KV integration cost?
The State KV integration is included on all Weavz plans including the free tier with 20,000 actions per month. No credit card required.
Connect State KV in minutes
Get 20,000 free action executions every month. No credit card required.