Advertise
MCP.so
Sign In

MCP Turso

@nbbaier

Repository

Basic information

Category

Databases

License

MIT

Transports

stdio

Author

nbbaier

About MCP Turso

MCP server for interacting with Turso-hosted LibSQL databases

#sql#ai#sqlite#mcp#turso#libsql#model-context-protocol#mcp-server

MCP Turso config

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

{
  "mcpServers": {
    "turso": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-turso"
      ],
      "env": {
        "TURSO_DATABASE_URL": "",
        "TURSO_AUTH_TOKEN": ""
      }
    }
  }
}

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.

Fetch the live tool list by running this server in a temporary sandbox using the button above.

Overview

What is mcp-turso?

mcp-turso is a Model Context Protocol (MCP) server that provides access to Turso-hosted LibSQL databases. It allows AI assistants to retrieve database tables, view schemas, describe tables, and perform SELECT queries.

How to use mcp-turso?

Add the server to your MCP client's configuration (e.g., in Claude Desktop or Cursor) by running npx -y mcp-turso and setting the environment variables TURSO_DATABASE_URL and TURSO_AUTH_TOKEN. You need an existing Turso database with its URL and token, which you can obtain via the Turso CLI. Logs are written by default to ~/.npm/_npx/<npx-dir-name>/node_modules/mcp-turso/logs/mcp-turso.log, and a custom path can be specified with the --logs flag (absolute posix path).

Key features of mcp-turso

  • List all tables in a Turso database
  • Retrieve full database schema as SQL statements
  • Describe a specific table’s column names and types
  • Execute SELECT queries and return results
  • Custom logging support for debugging

Use cases of mcp-turso

  • An AI assistant exploring the structure of a Turso database
  • Running ad‑hoc SELECT queries on Turso‑hosted data
  • Automating schema documentation or migration checks
  • Debugging database content without a separate SQL client

Frequently asked questions

1

What tools does mcp-turso expose?

It provides four tools: `list_tables`, `get_db_schema`, `describe_table`, and `query_database`. The first two require no input; `describe_table` takes a table name; `query_database` takes a SELECT SQL string.

2

How do I obtain my Turso database URL and token?

Use the Turso CLI: `turso db show --url <database-name>` for the URL, and `turso db tokens create <database-name>` for the token. You must have a Turso account and an existing database.

3

Can I write to the database (INSERT/UPDATE/DELETE)?

No. The server currently only supports SELECT queries. Write operations are listed as a future todo.

4

Where are the server logs stored?

By default, logs are written to `<parent-dir>/logs/mcp-turso.log`, where `<parent-dir>` is the parent of the directory containing the `mcp-turso` script. When run with npx, the default path is under `~/.npm/_npx/.../node_modules/mcp-turso/logs/`. A custom path can be set with the `--logs` flag (absolute posix path). The log location is printed to stderr on startup.

5

What authentication does the server require?

You must provide a `TURSO_AUTH_TOKEN` environment variable, which is the authentication token for your Turso database. This is set in the MCP client configuration (e.g., `claude_desktop_config.json`).

Comments

More Databases MCP servers

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

Elasticsearch MCP Server

elastic

685

ClickHouse MCP Server

ClickHouse

Connect ClickHouse to your AI assistants.

818

nuzur

nuzur is a model-first database platform for MySQL and PostgreSQL. The MCP server lets any AI assistant or agent (Claude, Cursor, Gemini, or anything else that speaks MCP) design your schema, query your data, generate mi

MCP DB Wizard

srmadscience

Oracle MCP server with no run-sql tool: It generates tools for each of the PL/SQL procedures, tables and approved SQL you choose. The server doesn't expose a SQL prompt, and can't reveal how it's connected to Oracle.

1
Advertise