Advertise
MCP.so
Sign In

MCP Turso

@spences10

Repository

Basic information

Category

Databases

License

MIT

Transports

stdio

Author

spences10

About MCP Turso

🗂️ A Model Context Protocol (MCP) server that provides integration with Turso databases for LLMs. This server implements a two-level authentication system to handle both organization-level and database-level operations, making it easy to manage and query Turso databases directly

#mcp#vector-database#turso#turso-db#model-context-protocol

MCP Turso config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "mcp-turso": {
      "command": "node",
      "args": [
        "/path/to/mcp-turso/dist/index.js"
      ],
      "env": {
        "TURSO_API_TOKEN": "your-turso-api-token",
        "TURSO_ORGANIZATION": "your-organization-name",
        "TURSO_DEFAULT_DATABASE": "optional-default-database"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

MCP Turso tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is mcp-turso?

mcp-turso is a Model Context Protocol (MCP) server that integrates Turso databases with LLMs, using a two-level authentication system to manage organization-level and database-level operations directly from LLMs.

How to use mcp-turso?

Configure the server in your MCP client (e.g., Cline or Claude Desktop) by setting the required environment variables TURSO_API_TOKEN and TURSO_ORGANIZATION, and optionally TURSO_DEFAULT_DATABASE. Run with npx -y mcp-turso-cloud. Invoke tools like list_databases, create_database, execute_read_only_query, or vector_search via the LLM.

Key features of mcp-turso

  • Two-level authentication (organization and database tokens)
  • Organization operations: list, create, delete databases, generate tokens
  • Database operations: list tables, read-only and destructive SQL queries
  • Vector similarity search using SQLite vector extensions
  • Schema description via describe_table tool
  • Security separation between read-only and destructive queries

Use cases of mcp-turso

  • Let an LLM list all databases in a Turso organization and manage them
  • Query a specific database with read-only SQL (SELECT, PRAGMA) through an LLM
  • Automate database schema exploration and table description in conversational workflows

Frequently asked questions

1

What distinguishes read-only from destructive queries?

The server provides separate tools: `execute_read_only_query` for SELECT/PRAGMA (safe, can be auto-approved) and `execute_query` for INSERT/UPDATE/DELETE/CREATE (requires explicit approval).

2

What environment variables are required?

`TURSO_API_TOKEN` (Turso Platform API token) and `TURSO_ORGANIZATION` (organization name) are required. `TURSO_DEFAULT_DATABASE`, `TOKEN_EXPIRATION` (default '7d'), and `TOKEN_PERMISSION` (default 'full-access') are optional.

3

How are database tokens managed?

Database tokens are generated automatically using the organization token, cached for performance, and rotated as needed. Their expiration and permissions can be configured via environment variables.

4

What transports or authentication does the server use?

The server uses standard MCP tool-based transport (stdio via `npx`), authenticating via the Turso Platform API token for organization-level actions and database-specific tokens for database-level operations.

5

Are there any known limits or dependencies?

The server depends on the @libsql/client and Turso’s API. It runs via Node.js and requires network access to Turso. No other runtime dependencies are mentioned.

Comments

More Databases MCP servers

Xata MCP Server

The Xata MCP server lets AI assistants and agents interact with your Xata organizations, projects, and Postgres database branches.

Dbhub

bytebase

Zero-dependency, token-efficient database MCP server for Postgres, MySQL, SQL Server, MariaDB, SQLite.

3.1K

Neon MCP Server

neondatabase-labs

MCP server for interacting with Neon Management API and databases

617

Postgres Mcp

crystaldba

Postgres MCP Pro provides configurable read/write access and performance analysis for you and your AI agents.

3.0K

MCP Alchemy

runekaagaard

A MCP (model context protocol) server that gives the LLM access to and knowledge about relational databases like SQLite, Postgresql, MySQL & MariaDB, Oracle, and MS-SQL.

412
Advertise