With MCP (Model Context Protocol), your AI assistant connects directly to your AstroBee data layers. Explore schemas, run SQL, and get insights without leaving Claude Code, Claude Desktop, or VS Code.
MCP is an open standard that lets AI assistants securely connect to external tools and data sources. AstroBee’s MCP server gives your assistant read access to your data layers and the ability to execute queries on your behalf.Managing Connections Access MCP settings via Settings → MCP tab:
The MCP page shows:
Authorized Applications — Apps currently connected to your accountSetup Instructions — Configuration for different AI clientsSecurity Information — How your data is protected
Quick Setup Claude Code
Claude Desktop
Other MCP Clients
Run this command in your terminal:
claude mcp add astrobee --transport http https://app.astrobee.ai/api/mcp
In Claude Code, type /mcp and select “Authenticate”
Sign in with your AstroBee account in the browser
Learn more about MCP in Claude Code .
Open Settings → Connectors → Add custom connector
Enter this URL:
https://app.astrobee.ai/api/mcp
Click Connect and sign in with your AstroBee account
Use this JSON configuration for any MCP-compatible client: { "astrobee" : { "type" : "http" , "url" : "https://app.astrobee.ai/api/mcp" } }
Once connected, your AI assistant has access to 12 tools:
Server & Model Discovery Tool Description server-statusCheck server health and connection statistics list-ontologiesList all data layers you have access to list-source-modelsGet raw data schemas linked to a data layer
Entity & Property Exploration Tool Description list-entitiesList all entities with metadata (optionally with row counts) list-propertiesGet all properties for a specific entity describe-propertyGet detailed info about a property (type, dimension/measure) list-relationshipsView how entities are connected
Statistics & Data Quality Tool Description list-entity-statsGet entity metrics (row count, property counts, quality scores) list-property-statsGet property statistics (uniqueness, null %, distinct counts)
SQL Execution Tool Description get-datasource-typeGet the database engine for correct SQL syntax validate-sqlCheck if a SQL query is valid without executing execute-sqlRun a SQL query and get results (up to 1000 rows)
For editing data layers, use the AstroBee web interface. MCP tools are read-only to maintain data layer consistency.
Security
OAuth 2.0 — Secure authorization flowScoped Access — Tools only access data you’ve authorizedRevocable — Remove access anytime from Settings → MCPAudit Logged — All queries are logged for security
Revoking Access To disconnect an authorized application:
Go to Settings → MCP
Find the application in the Authorized Applications list
Click Revoke
The application immediately loses access to your data.
Next Steps
Claude Desktop Tutorial Detailed setup guide for Claude Desktop
VS Code Tutorial Query data layers from VS Code
