Terra Config MCP Server
A Model Context Protocol server that allows LLMs to configure the TerraAPI dashboard.
Quickstart
Get started quickly with one of these installation options:
For Cursor users:
For VS Code users:
Available Tools
terra_get_integrations- Description: Get list of available integrations.
- Parameters: None
terra_get_detailed_integrations- Description: Retrieve a detailed list of supported integrations, filtered by the developer's enabled integrations and the requirement for SDK usage.
- Parameters:
sdk(Optional[bool]): If true, allows SDK integrations to be included in the response.
get_destinations- Description: Get destinations.
- Parameters: None
get_developer_destination_credentials- Description: Get developer destination credentials.
- Parameters:
destination(str): The destination to get credentials for.
delete_destination- Description: Delete a destination.
- Parameters:
destination(str): The destination to delete.dev_id(Optional[str]): Developer ID. If not provided, uses the environment variable.
set_destination_state- Description: Set destination state (active or inactive).
- Parameters:
destination(str): The destination to update.active(bool): Whether the destination should be active or not.
add_developer_destination- Description: Add developer destination.
- Parameters:
destination(str): The destination type to add (e.g. 's3', 'sql', 'webhook').scheme(str): The scheme (e.g 's3/postgres/https/mysql').host(str): The host (e.g 'webhook.site', 'eu-west-2', 'localhost').path(Optional[str]): The path (e.g bucket name, database name, webhook path without leading '/').user(Optional[str]): Username for credentials.password(Optional[str]): Password for credentials.port(Optional[int]): Port for the service if needed.query(Optional[str]): Query string if needed.certificate(Optional[str]): Certificate for certain destinations like GCS.complete_destination(bool, default: True): If true, ping the destination before adding.
ping_developer_destination- Description: Ping a developer destination to check if it's reachable.
- Parameters:
destination(str): The destination type to ping.scheme(str): The scheme (e.g 's3/postgres/https/mysql').host(str): The host (e.g 'webhook.site', 'eu-west-2', 'localhost').path(Optional[str]): The path (e.g bucket name, database name, webhook path).user(Optional[str]): Username for credentials.password(Optional[str]): Password for credentials.port(Optional[int]): Port for the service if needed.query(Optional[str]): Query string if needed.certificate(Optional[str]): Certificate for certain destinations like GCS.
set_provider_keys- Description: Set provider keys.
- Parameters:
resource(str): The provider resource.client_id(str): The client ID for the provider.client_secret(str): The client secret for the provider.redirect_url(Optional[str]): The redirect URL for the provider.
get_provider_keys- Description: Get provider keys.
- Parameters:
resource(str): The provider resource.
get_developer_providers- Description: Get developer providers.
- Parameters: None
add_providers- Description: Add providers.
- Parameters:
providers(list[str]): list of providers to add.
deactivate_provider- Description: Delete provider.
- Parameters:
provider(str): The provider to deactivate.
set_provider_state- Description: Set provider state (active or inactive).
- Parameters:
provider(str): The provider to update.active(bool): Whether the provider should be active or not.
get_providers_by_popularity- Description: Get providers ranked by popularity.
- Parameters: None
add_custom_credentials- Description: Add custom credentials for a provider.
- Parameters:
provider(str): The provider to add credentials for.client_id(str): The client ID.client_secret(str): The client secret.redirect_url(Optional[str]): The redirect URL.
get_custom_credentials- Description: Get custom credentials for a provider.
- Parameters:
provider(str): The provider to get credentials for.
Installation
[!NOTE] You will need your
TERRA_API_KEYandTERRA_DEV_IDwhich is available from the dashboard
Using uv (recommended)
When using uv no specific installation is needed. We will
use uvx to directly run terramcp.
uv Installation
Mac / Linux
curl -LsSf https://astral.sh/uv/install.sh | sh
Windows
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
Using PIP
Alternatively you can install terramcp via pip:
pip install terramcp
After installation, you can run it as a script using:
python -m terramcp
Configuration
Configure for Claude.app
Add to your Claude settings:
Using uvx
{
"mcpServers": {
"terramcp": {
"command": "uvx",
"args": ["terramcp"],
"env": {
"TERRA_API_KEY": "your_api_key_here",
"TERRA_DEV_ID": "your-dev-id-here"
}
}
}
}
Using pip installation
{
"mcpServers": {
"terramcp": {
"command": "python",
"args": ["-m", "terramcp"],
"env": {
"TERRA_API_KEY": "your_api_key_here",
"TERRA_DEV_ID": "your-dev-id-here"
}
}
}
}
Configure for Zed
Add to your Zed settings.json:
Using uvx
"context_servers": [
"terramcp": {
"command": "uvx",
"args": ["terramcp"],
"env": {
"TERRA_API_KEY": "your_api_key_here",
"TERRA_DEV_ID": "your-dev-id-here"
}
}
],
Using pip installation
"context_servers": {
"terramcp": {
"command": "python",
"args": ["-m", "terramcp"],
"env": {
"TERRA_API_KEY": "your_api_key_here",
"TERRA_DEV_ID": "your-dev-id-here"
}
}
},
Configure for VS Code
For quick installation, use one of the one-click install buttons below...
For manual installation, add the following JSON block to your User Settings (JSON) file in VS Code. You can do this by pressing Ctrl + Shift + P and typing Preferences: Open User Settings (JSON) .
Optionally, you can add it to a file called .vscode/mcp.json in your workspace. This will allow you to share the configuration with others.
Note that the
mcpkey is needed when using themcp.jsonfile.
Using uvx
{
"mcp": {
"servers": {
"terramcp": {
"command": "uvx",
"args": ["terramcp"],
"env": {
"TERRA_API_KEY": "your_api_key_here",
"TERRA_DEV_ID": "your-dev-id-here"
}
}
}
}
}
Debugging
You can use the MCP inspector to debug the server. For uvx installations:
npx @modelcontextprotocol/inspector uvx terramcp
Or if you've installed the package in a specific directory or are developing on it:
cd path/to/servers/src/terramcp
npx @modelcontextprotocol/inspector uv run terramcp
License
terramcp is licensed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, please see the LICENSE file in the project repository.