Skip to main content

Tessell Model Context Protocol (MCP) server

Project description

Tessell MCP Server

Tessell MCP Server is your AI-powered command center for cloud data and services. It connects your favorite IDEs (like VS Code, Cursor) or chat-based clients (like Claude) to Tessell—so you can manage everything using natural language.

With simple prompts, you can:

  • Manage services, snapshots, and availability machines
  • Explore and operate Tessell databases (Oracle, PostgreSQL, and more)
  • Run queries, check health, and troubleshoot—without switching tools or writing scripts

Just describe what you want to do—Tessell MCP Server takes care of the rest.

Why Use Tessell MCP Server?

  • Conversational Power: Manage your cloud and databases using plain language—no scripts or CLI required
  • Unified Control: Access all your Tessell services and databases from one place
  • Instant Insights: Query, analyze, and troubleshoot in seconds
  • Secure & Local: Your credentials stay safe—nothing leaves your environment unless you approve it

Installation & Configuration

Requirements

  • Tessell account with an active API key
  • Tenant API base URL and Tenant ID
  • Compatible MCP client (e.g., Claude Desktop, Cursor)

Configuration

To set up the Tessell MCP Server, add the following configuration to your MCP client's configuration file (such as mcp_config.json):

{
  "mcpServers": {
    "tessell": {
      "command": "uvx",
      "args": [
        "tessell-mcp@latest"
      ],
      "env": {
        "TESSELL_API_BASE": "{your-tenant-api-url}",
        "TESSELL_API_KEY": "{your-api-key}",
        "TESSELL_TENANT_ID": "{your-tenant-id}",
        "DATABASE_CONFIG_PATH": "/path/to/database-credentials.json"
      }
    }
  }
}

Database Connections

Tessell MCP Server automatically connects to your Tessell databases using the service API. You only need to provide database credentials in a secure JSON configuration file.

1. Create a database credentials file (e.g., database-credentials.json):

{
  "database_credentials": {
    "my_postgres_service": {
      "prod_db": {
        "username": "master",
        "password": "your_password_here"
      },
      "staging_db": {
        "username": "app_user",
        "password": "app_password"
      }
    },
    "analytics_service": {
      "reporting": {
        "username": "analyst",
        "password": "analyst_password"
      }
    }
  }
}

Tessell MCP supports PostgreSQL and Oracle, with MySQL and SQL Server coming soon. Use the standard URI format for your database engine.

Be sure to replace the placeholders with your actual database information and keep your credentials secure.

What You Can Do

Service

Manage your data services deployed on Tessell with ease - Discover services, manage snapshots, and control lifecycles—across clouds and environments—using simple prompts.

Action Example Prompt
See all my services Show me all running services
Get details about a service Show details for the 'hr' service
List databases in a service List all databases in the analytics service
Find a service by name Find all services with 'prod' in the name
Start/stop a service Stop the integration test service
Manage snapshots Create a snapshot named 'pre-upgrade' for the hr availability machine
List snapshots Show all snapshots for the analytics availability machine

Database

Seamlessly interact with your Tessell databases—explore metadata, run queries, and troubleshoot performance with simple natural language commands.

Action Example Prompt
Create a new database (Postgres) Create a db named prod_reporting with analytics connection
List schemas in a database Show me all schemas in the analytics database
List tables/views in a schema List all tables and views in the public schema of sales
Describe a table or view Describe the structure of the 'orders' table in reporting
Get sample data Show me 5 sample rows from the 'customers' table
Run a custom query Get top 10 transactions with amount greater than 1000
See slowest queries What are the slowest queries running on analytics?
Check database health Check the health of indexes and vacuum status in hr
Explain a query plan Explain the query plan for 'SELECT * FROM sales WHERE region = 'US''

Tessell Documentation

Get answers directly from Tessell’s documentation—search across product guides and configuration help, right from the MCP interface.

Action Example Prompt
Search documentation What is Parameter Profile in Tessell?
Find setup instructions How do I configure IAM in Tessell?
List available features What can I do with Tessell's governance app?

Security Notes

  • Tessell MCP Server is intended for local development and IDE integrations only.
  • Keep your API key and tenant credentials secure and private.
  • Review and approve all actions before allowing execution via the MCP client.
  • Database connection files should be kept secure and not committed to version control.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

tessell_mcp-0.1.12.tar.gz (40.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

tessell_mcp-0.1.12-py3-none-any.whl (39.5 kB view details)

Uploaded Python 3

File details

Details for the file tessell_mcp-0.1.12.tar.gz.

File metadata

  • Download URL: tessell_mcp-0.1.12.tar.gz
  • Upload date:
  • Size: 40.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.5

File hashes

Hashes for tessell_mcp-0.1.12.tar.gz
Algorithm Hash digest
SHA256 aa123ebae11ee96f0807a2e506ca26501554cb1582aa0e94bef0c2cdf104c86d
MD5 bf487a8693e0507f7457d718120e5653
BLAKE2b-256 4fa55256a405cbdda05d0546fcb556185bc9de1e5c151cd8f4d678b148ca5e20

See more details on using hashes here.

File details

Details for the file tessell_mcp-0.1.12-py3-none-any.whl.

File metadata

  • Download URL: tessell_mcp-0.1.12-py3-none-any.whl
  • Upload date:
  • Size: 39.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.5

File hashes

Hashes for tessell_mcp-0.1.12-py3-none-any.whl
Algorithm Hash digest
SHA256 fba9fbea6bdc177ff6c62fde361f062a4f2899bc170b469e773f3b3170360158
MD5 1ce266e5766ec615c082c1c6b60d5e2b
BLAKE2b-256 8477e1a5734f664344334dadd47e67d19c6f856ced8a15f1fe6e9da09f955f39

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page