Astra DB
Astra DB tools for agents: schema, find, vector search, guarded writes, and interactive views.
Connector by erichare · GitHub account verified by the MCP Registry
Chalk Labs
Need help deploying Astra DB?
Chalk Labs sets up agents like this inside real teams: connected to your tools, tested on your data, with a human in the loop where it matters.
Install
Works with Claude Code, VS Code, Codex, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.
npx agentmarket install connector/erichare-astra-mcp
Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.
Remote endpoint
https://astra-widgets-mcp.vercel.app/mcpRemote (HTTP)
Get the weekly diff
The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.
About
Reviews
Write a reviewNo reviews yet. Installed it? Reviews come from verified installers only. How reviews work
Permissions
What this server can do and what it asks for, from its tool list and install config. Checked Oct 25, 2026.
- Tools
- 11 read · 4 write · 3 delete
- Secrets
- 1 (API keys, tokens or passwords)
- Install scripts
- Not scanned yet
- Runs as
- Node.js package
Tools by what they do 18
Read from the source code; the running server may list different tools.
Read 11 · Look things up without changing anything.
code_examplesconnection_statuscountdatabase_overviewdescribe_collectiondescribe_tabledistinct_valuesfindlist_databaseslist_vectorize_providersvector_search
Write 4 · Create, change, send or run things.
create_collectioncreate_indexcreate_tableinsert
Delete 3 · Delete, drop, revoke or wipe things.
deletedropupdate
Secrets and settings it asks for
Secrets: values you paste in that let it act as you.
ASTRA_DB_APPLICATION_TOKEN
Other settings (environment variables or headers).
ASTRA_DB_API_ENDPOINTASTRA_DB_KEYSPACEASTRA_MCP_READ_ONLY
Network hosts it talks to 1
astra-widgets-mcp.vercel.app· found in remote endpoint, install command
Tools (18)
Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].
code_examplesData API code examplesread-onlyCanonical Data API client code for Python (astrapy), TypeScript (@datastax/astra-db-ts), Java, C#, and Go from the bundled, documentation-derived example library. Use when writing application code; snippets read ASTRA_DB_APPLICATION_TOKEN / ASTRA_DB_API_ENDPOINT from the environment.
connection_statusAstra DB connection statusread-onlyCheck whether Astra DB credentials are configured and working: where the token, endpoint, and keyspace come from (env, .env, plugin settings, Astra CLI), which database is targeted, and a live connectivity check. Call it first when another tool reports not_configured or an auth error.
countCount documentsread-onlyExact count of documents in a collection matching a filter, up to upperBound (Data API maximum 1000); unfiltered counts also report the estimated total.
create_collectionCreate collectionCreate a collection: plain JSON, vector (dimension + metric), or vectorize (server-side embeddings from a provider — see list_vectorize_providers), optionally with lexical (BM25) and rerank for hybrid search, indexing allow/deny, and a default id type. Idempotent when the settings match an existing collection.
create_indexCreate table indexCreate an index on a table column: regular (filtering and sorting), vector (similarity search on a vector column), or text (BM25 lexical search). Collections index fields automatically.
create_tableCreate tableCreate a table with typed columns (text, int, uuid, timestamp, map/list/set, vector…) and a primary key (partition columns plus optional clustering order). Then add indexes with create_index for columns you filter or vector-search on.
database_overviewAstra DB overviewread-onlyMap a database: keyspaces → collections (vector dimension/metric, vectorize model, lexical/rerank, estimated counts) and tables (column and vector-column counts). Start here to see what exists. Renders an interactive overview.
deleteDelete documents or rowsDelete the document/row matching a filter. `many` deletes every match; `many` or an empty filter requires the user's confirmation.
describe_collectionDescribe collectionread-onlyShow one collection's configuration and shape: vector settings, vectorize and rerank services, lexical, indexing allow/deny, default id type, estimated count, and a sample document with field types. Use before writing queries or code against it.
describe_tableDescribe tableread-onlyShow one table's schema: columns and types, primary key (partition and clustering columns), indexes, vector columns, and sample rows. Use before writing queries or code against it.
distinct_valuesDistinct valuesread-onlyDistinct values of a field (dot paths allowed) across up to scanLimit documents or rows, optionally filtered — useful for discovering categories before filtering.
dropDrop collection, table, or indexPermanently drop a collection, a table, or a table index, with all its data. Always requires the user's explicit confirmation.
findFind documents or rowsread-onlyRead documents (collections) or rows (tables) with an optional Data API filter, sort, and projection. Returns pages of 20 plus nextPageState for more. For similarity search use vector_search. Renders an interactive explorer.
insertInsert documents or rowsInsert 1–1000 documents into a collection (or rows into a table), in chunks. On vectorize collections use "$vectorize": "text" to embed server-side; otherwise "$vector": [...] for your own embeddings. Reports inserted ids and any per-document errors.
list_databasesList Astra databasesread-onlyList the Astra databases this token can access (DevOps API): name, id, status, regions with Data API endpoints, and keyspaces. Use it to choose the `database` argument of other tools.
Show 3 more tools
list_vectorize_providersVectorize providersread-onlyList the embedding (vectorize) and reranking providers and models available to the database, with dimensions and authentication options. Use before create_collection with a vectorize service.
updateUpdate documents or rowscan change or delete dataUpdate the document/row matching a filter with operators ($set, $unset, $inc, $push, …). `many` updates every match (collections only); `many` or an empty filter requires the user's confirmation. `upsert` inserts when nothing matches.
vector_searchVector searchread-onlySimilarity search by natural-language `query` (server-side vectorize), an explicit `vector`, or `documentId` (more like this). `hybrid` combines vector and lexical (BM25) results with reranking on collections that have both. A filter narrows candidates. Returns ranked hits with similarity scores; renders an interactive results view.
Signals
- Stars
- 0
- Forks
- 0
- Open issues
- 0
- Weekly downloads
- 18
- Last commit (this folder)
- Oct 13, 2026 (17 days ago)
- Last release
- Sep 30, 2026 (1 month ago)
- Last package publish
- Sep 29, 2026 (1 month ago)
From GitHub (fetched Oct 24, 2026) and the package registry.
Details
- Registry name
io.github.erichare/astra-mcp- Version
- 2.0.0
- Auth
- Auth not stated, API key
- Packages
- npm @erichare/astra-mcp
- License
- Apache-2.0
- Repository
- github.com/erichare/astra-db-plugin
- First seen
- Oct 24, 2026
- Last checked
- Oct 25, 2026
Done for you
Rather not set it up yourself?
Chalk Labs scopes, builds and runs agents for your team: the task audit, the eval harness, the integrations and the weekly ops report. Fixed scope, priced before we start.
See how we build AI agents →Read the case studies
Chalk Labs is a two-founder AI and growth studio. We build AI agents, CRMs and MVPs for Web3 and AI companies, and have shipped 50+ product and token launches.
- launches shipped
- 50+
- launches shipped
- media placements
- 500+
- media placements
- founders on every account
- 2
- founders on every account
Press we've placed: Forbes · CoinDesk · Decrypt · Cointelegraph · The Block
Rahil Jain, Co-founder, Chalk Labs. Ex-Goldman Sachs engineer. You talk to the person who builds it.
Get Astra DB running in your business
Tell us what you want to automate. A founder replies within one working day with a plan, not a pitch deck.
Cite this page
Astra DB MCP server. Agent Mart. https://agentmart.dev/connectors/erichare-astra-mcp (last updated 2026-10-25)