Astra Db MCP Server

A Model Context Protocol (MCP) server for interacting with Astra DB. MCP extends the capabilities of Large Language Models (LLMs) by allowing them to

Local serverstdioGo

What is the Astra Db MCP Server?

A Model Context Protocol (MCP) server for interacting with Astra DB. MCP extends the capabilities of Large Language Models (LLMs) by allowing them to interact with

Credentials and setup notes

You need to have a running Astra DB database. If you don't have one, you can create a free database here. From there, you can get two things you need: 1. An Astra DB Application Token 2. The Astra DB API Endpoint To learn how to get these, please [read the getting started

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
GetCollectionsGet all collections in the active keyspace
GetCollectionInfoInspect collection options, vector settings, and default ID configuration
CreateCollectionCreate a collection with vector options, distance metrics (cosine, euclidean, dot_product), and auto-vectorize configurations
UpdateCollectionUpdate or rename a collection
DeleteCollectionDelete a collection
EstimateDocumentCountGet an approximate count of documents in a collection
ListRecordsList records with optional sorting, pagination (skip), and projection
GetRecordGet a specific record by ID
CreateRecordInsert a single document
UpdateRecordUpdate a record
DeleteRecordDelete a record by ID
FindRecordFind records by exact field value match
FindWithFilterRich querying with MongoDB-style filter operators ($and, $or, $gt, $in, $exists, etc.)
FindDistinctValuesFind distinct values for a specific field in a collection
BulkCreateRecordsInsert multiple documents in batch
BulkUpdateRecordsUpdate multiple documents in batch
BulkDeleteRecordsDelete multiple documents in batch
FindWithVectorDense vector similarity search with optional metadata filters, similarity scores, and projection
FindWithVectorizeNatural language search query using Astra DB Vectorize serverless embeddings
FindAndRerankHybrid search (lexical + dense vector / auto-vectorize) with server-side reranking scores
VectorSearchVector similarity search with minScore threshold and projection
HybridSearchCombine dense vector similarity and text search with weighted scoring
ListTablesList all structured tables in the keyspace
CreateTableCreate a typed table with column definitions and primary keys
AlterTableAdd or drop columns (including vector columns)
DropTableDrop a table
QueryTableQuery table rows with filters, sorting, projection, and pagination
InsertTableRowInsert a single row or batch of rows into a table
UpdateTableRowUpdate matching rows in a table
DeleteTableRowDelete matching rows from a table
CreateTableIndexCreate a secondary index on a table column
CreateTableVectorIndexCreate a vector index on a table column with similarity metrics
ListKeyspacesList all keyspaces in the database
CreateKeyspaceCreate a new keyspace with optional automatic switching
DropKeyspaceDrop a keyspace
UseKeyspaceSwitch the active working keyspace for subsequent operations
GetCurrentKeyspaceInspect the active keyspace name
ListEmbeddingProvidersDiscover supported embedding models and providers
ListRerankingProvidersDiscover supported reranking models
GetDatabaseInfoRetrieve environment metadata (ID, region, status, keyspaces)
OpenBrowserOpen a browser for authentication/setup
HelpAddToClientAssistance with MCP client installation

How to install the Astra Db MCP Server

{
  "mcpServers": {
    "astra-db-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@datastax/astra-db-mcp"
      ],
      "env": {
        "ASTRA_DB_APPLICATION_TOKEN": "YOUR_ASTRA_DB_APPLICATION_TOKEN",
        "ASTRA_DB_API_ENDPOINT": "your_astra_db_endpoint"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

You need to have a running Astra DB database. If you don't have one, you can create a free database here. From there, you can get two things you need: 1. An Astra DB Application Token 2. The Astra DB API Endpoint To learn how to get these, please [read the getting started

VariableDescriptionRequired
ASTRA_DB_APPLICATION_TOKENDeclared in the maintainer’s client configuration.Check documentation
ASTRA_DB_API_ENDPOINTDeclared in the maintainer’s client configuration.Check documentation

Example prompts to try

  • “Use Astra Db MCP to Cursor.”
  • “Use Astra Db MCP to Utility.”
  • “Use Astra Db MCP to VectorSearch.”

Frequently asked questions

A Model Context Protocol (MCP) server for interacting with Astra DB. MCP extends the capabilities of Large Language Models (LLMs) by allowing them to interact with Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.