secoda-mcp-server

MCP (Model Context Protocol) server for the Secoda data catalog and observability API. Exposes ~75 tools covering the full Secoda API surface, enabling AI assistants to browse catalogs, manage metadata, trace lineage, monitor data quality, and more.

Installation

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "secoda": {
      "command": "npx",
      "args": ["-y", "secoda-mcp-server"],
      "env": {
        "SECODA_API_KEY": "your-api-key-here"
      }
    }
  }
}

OpenCode

Add to your mcp.json (typically at .config/opencode/mcp.json):

{
  "secoda": {
    "command": "npx",
    "args": ["-y", "secoda-mcp-server"],
    "env": {
      "SECODA_API_KEY": "your-api-key-here"
    }
  }
}

For US or other regions, add the base URL:

{
  "secoda": {
    "command": "npx",
    "args": ["-y", "secoda-mcp-server"],
    "env": {
      "SECODA_API_KEY": "your-api-key-here",
      "SECODA_BASE_URL": "https://api.secoda.co"
    }
  }
}

Other MCP clients

npx secoda-mcp-server --api-key <your-key>

Configuration

| Method | Variable / Flag | Description | |--------|----------------|-------------| | Env var | SECODA_API_KEY | Your Secoda API key (required) | | CLI flag | --api-key <key> | Overrides env var | | Env var | SECODA_BASE_URL | API base URL (optional) | | CLI flag | --base-url <url> | Overrides env var |

Regional base URLs:

| Region | URL | |--------|-----| | US (default) | https://api.secoda.co | | EU | https://eapi.secoda.co | | APAC | https://aapi.secoda.co | | On-prem | Your custom domain |

Get your API key from Secoda Settings > API.

Tools

Resources (Catalog)

| Tool | Description | |------|-------------| | list_resources | Search the catalog with filters (type shortcut, title search, or advanced JSON filter) | | create_resource | Create a new catalog resource | | get_resource | Get a resource by UUID | | update_resource | Update resource metadata | | delete_resource | Delete a resource | | bulk_update_resources | Update up to 100 resources at once |

Integrations

| Tool | Description | |------|-------------| | list_integrations | List all integrations | | create_integration | Create a new integration | | get_integration | Get an integration by ID | | delete_integration | Delete an integration | | trigger_dbt_sync | Trigger a dbt sync for an integration | | get_dbt_failing_tests | Get failing dbt tests for an integration |

Lineage

| Tool | Description | |------|-------------| | list_lineage | List manual lineage relationships | | create_manual_lineage | Create a manual lineage link | | get_lineage | Get a lineage relationship by ID | | delete_lineage | Delete a lineage relationship | | preview_lineage_from_query | Preview lineage derived from a SQL query | | create_lineage_from_query | Create lineage from a SQL query | | create_lineage | Create a lineage relationship |

Tags

list_tags, create_tag, get_tag, update_tag, delete_tag

Users & Groups

list_users, get_user, update_user, list_groups, create_group, get_group, update_group, delete_group

Teams

list_teams, list_teams_v2, create_team, get_team, update_team, delete_team

Collections

list_collections, create_collection, get_collection, update_collection, delete_collection

Questions & Replies

list_questions, create_question, get_question, update_question, delete_question, list_replies, create_reply, get_reply, update_reply, delete_reply

Documents

list_documents, create_document, get_document, update_document, delete_document

Monitors & Observability

list_monitors, create_monitor, get_monitor, run_monitors, list_incidents, get_incident, list_measurements

Events

list_event_categories, create_event_category, get_event_category, update_event_category, delete_event_category, list_events, create_event, get_event, update_event, delete_event, list_event_properties, create_event_property, get_event_property, update_event_property, delete_event_property

Custom Properties

list_custom_properties, create_custom_property, get_custom_property, update_entity_custom_property, bulk_update_custom_properties

Audit Logs

list_audit_logs, list_resource_logs

AI Analytics

get_ai_chat_metrics, get_ai_chat_timeseries, list_ai_chat_messages, list_ai_rated_messages, list_ai_prompts_by_member

Glossary

list_glossary_terms, create_glossary_term, get_glossary_term, update_glossary_term, delete_glossary_term

Queries & Slack

get_query, list_slack_conversations

Notes

• List tools return one page of results. Use the page parameter to paginate.
• Rate limit: 30 write operations per minute. The server surfaces 429 errors with a clear message.
• All tools work with any Secoda plan that has API access.

License

MIT