Astra DB tools for agents: schema, find, vector search, guarded writes, and interactive views.
Quick Install
Automated & IDE SetupCopy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.
One-click editor setup isn’t available for this listing yet — we don’t have a confirmed install command, and we’d rather show nothing than point your editor at the wrong package or host. Follow the project’s own setup instructions, linked above.
Manual Client & Custom JSON ConfigExpand JSON â–¾
No confirmed setup config for this listing yet. We only publish a config block when the install details come from the project itself — its README, its docs, or a verified owner. We haven’t found those for Astra DB, and we’d rather show nothing than a guess you’d paste into your client. Follow the project’s own setup instructions for the current steps.
Documentation Overview
18 MCP tools · interactive views · guarded writes · ~1,660 Data API examples in 5 languages
Claude Code · Codex · Cursor · VS Code · Windsurf · Gemini CLI · Claude Desktop · IBM Bob · ChatGPT
Give your coding agent a live view of your Astra DB. It can map a database, read a collection's real schema before writing code against it, run vector and hybrid searches, page through documents, and change data, asking you first before anything destructive. When it writes application code, it starts from canonical Data API snippets for Python, TypeScript, Java, C#, and Go instead of guessing.
Quickstart
init finds the agents on your machine and sets each one up. Claude Code and Codex get the full plugin (skills, hooks, and the MCP server) from their plugin marketplaces; the others get the MCP server in their config. Then it connects a database:
- Paste an application token at a hidden prompt. Create one in the Astra console under Settings → Tokens.
- Pick a database and a keyspace.
ASTRA_DB_APPLICATION_TOKEN,ASTRA_DB_API_ENDPOINT, andASTRA_DB_KEYSPACEare written to./.env(mode 0600), andloginoffers to add.envto.gitignoreif it isn't ignored yet.
No restart needed: the server re-reads credentials on every call. Now ask your agent:
What's in my Astra database?
Find articles similar to "how do black holes evaporate".
Write a TypeScript script that loads
products.jsoninto a new vectorize collection.
Needs Node.js 20+. Prefer a one-liner? curl -fsSL https://raw.githubusercontent.com/erichare/astra-db-plugin/main/install.sh | sh (PowerShell: irm https://raw.githubusercontent.com/erichare/astra-db-plugin/main/install.ps1 | iex) runs the same init.
See your data
In hosts that render MCP Apps, such as Claude and ChatGPT, the overview, schema, explorer, and search tools answer with an interactive view: drill from a database into a collection, its documents, and similar documents, with a Back history, your host's theme, and full keyboard support. Elsewhere, the agent gets the same data as text, and can write a standalone HTML page when you ask for a visual.
 |  |
 |  |
 |  |
In Claude Code, the shortcuts are /astra-db:overview, /astra-db:collection <name>, /astra-db:explore <name> [--filter '<json>'], and /astra-db:similar "<query>" <collection>.
Tools
| Tools | |
|---|---|
| Connect | connection_status shows where each credential comes from and runs a live check; list_databases |
| Explore | database_overview, describe_collection, describe_table, list_vectorize_providers |
| Query | find (filter, sort, projection, paging), vector_search (text via vectorize, a vector, or "more like this document"; hybrid with rerank), count, distinct_values |
| Build | code_examples searches the bundled, documentation-derived client snippets, offline |
| Change | insert, update, delete, create_collection, create_table, create_index, drop |
Every data tool takes an optional database (name, id, or endpoint) and keyspace, so one server covers all your databases. The server also exposes astra://databases and per-collection schema resources, plus overview, explore, similar, and setup prompts. Arguments, outputs, and error codes: docs/tools.md.
Safe by default
- Destructive changes need your say-so.
drop, andupdateordeleteacross many documents or with an empty filter, need confirmation. Clients that support elicitation ask you directly. Otherwise the agent has to show you what will be lost and wait for your approval; the request that started it doesn't count. - Read-only when you want it.
ASTRA_MCP_READ_ONLY=1,astra-mcp serve --read-only, or the plugin's Read-only setting removes every write tool. - Tokens stay out of the chat.
loginreads the token with hidden input, and the tools send the agent tologin, never to you for a token. If you paste one anyway, the agent is told not to use it and to suggest rotating it. - A guard against leaks. In Claude Code, Codex, and Bob, a hook stops
AstraCS:tokens from being written anywhere except a git-ignored.env. Removing a leaked token is always allowed. - Hosted writes are opt-in, per connection: the Allow writes box on the OAuth consent page, or an explicit header.
More in docs/security.md.
Works with
init handles all of these; pick a subset with --agents claude-code,cursor, use project-level files with --project, and preview with --dry-run. npx -y @erichare/astra-mcp uninstall reverses it.
| Agent | What you get | Manual setup |
|---|---|---|
| Claude Code | Plugin: skills, /astra-db:* shortcuts, hooks, MCP server, settings for token, endpoint, keyspace, and read-only | claude plugin marketplace add erichare/astra-db-pluginclaude plugin install astra-db@astra-db-marketplace |
| OpenAI Codex | Plugin: skills ($astra-db:*), hooks, MCP server | codex plugin marketplace add erichare/astra-db-plugincodex plugin add astra-db@astra-db-marketplace |
| Cursor | MCP server in ~/.cursor/mcp.json |  |
| VS Code (Copilot) | MCP server in your user profile |  |
| Windsurf | MCP server in ~/.codeium/windsurf/mcp_config.json | init --agents windsurf |
| Gemini CLI | MCP server in ~/.gemini/settings.json | init --agents gemini |
| Claude Desktop | MCP server in claude_desktop_config.json | Or open astra-db.mcpb for a one-click install with a settings form |
| IBM Bob | Skills, /astra-* commands, three custom modes, rules, hooks, MCP server in ~/.bob/ | docs/bob.md |
| ChatGPT, claude.ai | Hosted server with OAuth | docs/hosted.md |
| Any MCP client | stdio server | npx -y @erichare/astra-mcp |
Skills-only harnesses that read the Agent Skills layout can take the skills/ directory as is.
What the agent knows
| Skill | Purpose |
|---|---|
astra-toolkit | The knowledge base: Collections vs Tables, data modeling, the Astra CLI, application architecture, and about 340 examples per language with per-language indexes. Written by Stefano Lottini (IBM / DataStax), vendored and extended here |
astra-widgets | When to show a view, and how to render one where MCP Apps aren't available |
setup, doctor | Connect a project, and diagnose one that isn't working, with the exact fix per failure |
data-model-review | Review the project's data model and Data API usage against the live schema |
overview, collection, explore, similar | Shortcuts you invoke; the agent doesn't trigger them on its own |
reviewer, data-modeler, migration-helper | Personas: a read-only code reviewer in a forked context, a schema designer, and a staged migration planner |
Configuration
Each value (token, endpoint, keyspace) comes from the first place that has it:
Related MCP Servers
Reviews
No reviews yet — be the first to share how this listing worked for you.
Frequently Asked Questions about Astra DB
AllMCPs Directory Badge
Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.
Badge Style:
Live Dynamic SVG Preview
Markdown (GitHub README)
[](https://allmcps.com/mcp/astra-db)HTML Embed
<a href="https://allmcps.com/mcp/astra-db"><img src="https://allmcps.com/api/badge/astra-db?style=directory" alt="Astra DB on AllMCPs" /></a>