MCP Server

Dynoxide includes a built-in MCP (Model Context Protocol) server with 34 tools. Your coding agent can create tables, query data, manage snapshots, and more - all without leaving the conversation.

Setup for Claude Code

Add this to your MCP configuration:

{
  "mcpServers": {
    "dynoxide": {
      "command": "dynoxide",
      "args": ["mcp", "--db-path", "dev.db"]
    }
  }
}

The agent now has full DynamoDB access through Dynoxide.

Setup for Cursor

Same config format. Add it to your Cursor MCP settings with the dynoxide mcp command.

Streamable HTTP transport

If you prefer HTTP over stdio:

dynoxide mcp --http --port 19280

Then point your agent to http://localhost:19280.

Available tools

The 34 tools are grouped by category:

Category	Tools	What they do
Tables	5	Create, describe, list, update, delete tables
Items	4	Get, put, update, delete individual items
Batch	3	Batch get, batch write, bulk put (up to 10K items)
Query & Scan	2	Query with key conditions and filters, full table scans
Transactions	2	Atomic multi-item reads and writes
PartiQL	3	SQL-like queries via ExecuteStatement
TTL	3	Manage time-to-live settings and sweep expired items
Streams	4	List, describe, and read DynamoDB Streams
Snapshots	4	Point-in-time backups and rollback
Tags	3	Tag and untag resources
Info	1	Database size, table count, storage mode

Safety controls

For read-only access (good for pointing at production snapshots):

dynoxide mcp --read-only --db-path prod-snapshot.db

To cap response sizes:

dynoxide mcp --max-items 100 --max-size-bytes 65536

Data model context

If you're using a single-table design with OneTable, you can pass the schema so the agent understands your entity model:

dynoxide mcp --data-model schema.json

The agent will see entity names, key templates, and GSI mappings in its instructions. This is context only - Dynoxide doesn't validate writes against the schema.

Getting Started

Usage

Reference