Gatlas/docs

MCP & API Keys

Share your portfolio data with AI assistants securely.

What is MCP

The Model Context Protocol (MCP) is an open standard that lets AI assistants connect to external data sources. Gatlas provides an MCP server that gives AI tools like Claude, Cursor, and others direct access to query your synced portfolio data, check sync health, and browse available schemas — all scoped to exactly what you want to share.

Creating an API key

1

Open the MCP page

Go to MCP / API in the sidebar.

2

Create a new key

Click Create API Key.

3

Name the key

Give it a descriptive name, e.g. "CFO Claude access" or "Portfolio analyst". This helps you identify which key is used for what when managing them later.

4

Choose the scope

Select what data this key can access. See scoping modes below.

Scoping modes

  • Organization — Full access to all entities and views. Use for trusted internal users who need to see the full portfolio.
  • Hierarchy — Access to a specific entity and all its children. Good for portfolio managers who oversee a sub-group of companies.
  • Explicit — Access to specific entities and/or views only. Most restrictive — use for external operators or limited-scope analysts.

Note

You can always revoke a key from the MCP / API page. Revoked keys stop working immediately.

The 9 MCP tools

  • list_entities — List portfolio companies
  • list_tables — Browse available database tables
  • query_sql — Run SQL queries against synced data
  • list_views — List published views
  • describe_view — Get view details, schema, and AI context
  • query_view — Query a published view with filters
  • get_sync_status — Check connection sync health
  • get_recent_syncs — Recent sync run history
  • trigger_sync — Manually trigger a data sync