# Dynobase

> Dynobase is an MCP server for databases. Let AI tools query DynamoDB through the Dynobase desktop app, read-only by default. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Free trial
- **Platforms:** macOS, Windows, Linux, CLI
- **Website:** https://dynobase.dev/dynamodb-mcp-server/
- **Repository:** https://github.com/dynobase/dynobase-mcp
- **MCP Registry name:** io.github.Dynobase/dynobase-mcp
- **Categories:** databases, developer tools
- **Listing updated:** 2026-11-14

## About

This server connects MCP clients to Dynobase 3.0, the desktop client for Amazon DynamoDB, so an assistant can work with your tables through AWS profiles already loaded in the app. Clients see tool results only and never receive your AWS credentials. Dynobase must stay running, because the MCP server lives inside the app and listens on 127.0.0.1 behind a bearer token you can regenerate.

Writes are blocked until you turn on Allow writes in Settings, AI, MCP server. Item writes made by a client are recorded in Dynobase's History with the previous version so they can be reverted, but PartiQL writes cannot be undone. AWS IAM permissions still apply to every request.

The npm-style bridge in the repository, MIT-licensed, serves clients that only launch stdio servers such as Claude Desktop, Codex and Windsurf. Claude Code and Cursor can connect over HTTP directly. Each call returns up to about 1 MB of items and times out after 60 seconds.

## Features

- **Reuses AWS profiles:** Lists loaded profiles and tables without copying keys into each client.
- **Read tools by default:** Scan, query, get item, PartiQL SELECT and describe table work without write access.
- **Index explanation:** Reports which index a key condition would use and whether it is a Query or a Scan.
- **Opt-in writes:** Put, update, delete and batch write stay blocked until Allow writes is enabled.
- **History for item writes:** Item writes are recorded with the previous version so they can be reverted.
- **Local token-protected server:** Listens on 127.0.0.1 only with a regenerable bearer token.

## Good for

- Ask a coding assistant what a DynamoDB table's schema looks like
- Run exploratory queries while building an app
- Check which index a query would hit before shipping it
- Make supervised item edits with a revert path

## Install

### Claude Code (Terminal)

```sh
claude mcp add dynobase-mcp -- npx -y https://github.com/Dynobase/dynobase-mcp/releases/download/v1.0.0/dynobase-1.0.0.mcpb
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "dynobase-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Dynobase/dynobase-mcp/releases/download/v1.0.0/dynobase-1.0.0.mcpb"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "dynobase-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Dynobase/dynobase-mcp/releases/download/v1.0.0/dynobase-1.0.0.mcpb"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "dynobase-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Dynobase/dynobase-mcp/releases/download/v1.0.0/dynobase-1.0.0.mcpb"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "dynobase-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Dynobase/dynobase-mcp/releases/download/v1.0.0/dynobase-1.0.0.mcpb"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "dynobase-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Dynobase/dynobase-mcp/releases/download/v1.0.0/dynobase-1.0.0.mcpb"
      ]
    }
  }
}
```

## Tools

- `list_profiles`: Lists loaded profiles with their regions and table names
- `list_tables`: Lists the table names of one profile
- `describe_table`: Returns the full DescribeTable output plus TTL
- `scan`: Returns one page of a Scan
- `query`: Returns one page of a Query
- `get_item`: Returns one item by primary key
- `partiql`: Runs one PartiQL statement, SELECT only unless writes are allowed
- `explain_query`: Says which index a key condition would use and whether it is a Query or a Scan

## FAQ

### Can the AI tool see my AWS keys?

No. The site says clients see tool results, never your credentials.

### Is it read-only?

Yes by default. Writes need Allow writes turned on in Dynobase.

### Can I undo a change?

Item writes are recorded in History and can be reverted; PartiQL writes cannot.

### Does Dynobase need to be running?

Yes, the local server is only available while the app is open.

### What does it cost?

The bridge is MIT-licensed, but Dynobase itself is a paid app with a 7-day free trial.

### Is Dynobase free?

Dynobase is a paid product with a free trial.

### How do I add Dynobase to Claude Code?

Run this command in your terminal: claude mcp add dynobase-mcp -- npx -y https://github.com/Dynobase/dynobase-mcp/releases/download/v1.0.0/dynobase-1.0.0.mcpb

### What are the best alternatives to Dynobase?

The closest alternatives to Dynobase are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/dynobase
