MCP Integration

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 account
Setup Instructions — Configuration for different AI clients
Security 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"
    }
}

Available Tools

Once connected, your AI assistant has access to 12 tools:

Server & Model Discovery

Tool	Description
`server-status`	Check server health and connection statistics
`list-ontologies`	List all data layers you have access to
`list-source-models`	Get raw data schemas linked to a data layer

Entity & Property Exploration

Tool	Description
`list-entities`	List all entities with metadata (optionally with row counts)
`list-properties`	Get all properties for a specific entity
`describe-property`	Get detailed info about a property (type, dimension/measure)
`list-relationships`	View how entities are connected

Statistics & Data Quality

Tool	Description
`list-entity-stats`	Get entity metrics (row count, property counts, quality scores)
`list-property-stats`	Get property statistics (uniqueness, null %, distinct counts)

SQL Execution

Tool	Description
`get-datasource-type`	Get the database engine for correct SQL syntax
`validate-sql`	Check if a SQL query is valid without executing
`execute-sql`	Run 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 flow
Scoped Access — Tools only access data you’ve authorized
Revocable — Remove access anytime from Settings → MCP
Audit 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

Get Started

Core Features

Settings

Security

Tutorials

Reference

Managing Connections

Quick Setup

Available Tools

Server & Model Discovery

Entity & Property Exploration

Statistics & Data Quality

SQL Execution

Security

Revoking Access

Next Steps

Claude Desktop Tutorial

VS Code Tutorial

Get Started

Core Features

Settings

Security

Tutorials

Reference

Documentation Index

​Managing Connections

​Quick Setup

​Available Tools

​Server & Model Discovery

​Entity & Property Exploration

​Statistics & Data Quality

​SQL Execution

​Security

​Revoking Access

​Next Steps

Claude Desktop Tutorial

VS Code Tutorial

Managing Connections

Quick Setup

Available Tools

Server & Model Discovery

Entity & Property Exploration

Statistics & Data Quality

SQL Execution

Security

Revoking Access

Next Steps