Skip to main content
Glama
jedshen123

App Data MCP

by jedshen123

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
DB_HOSTNoPostgreSQL host for audit logging
DB_NAMENoPostgreSQL database name for audit logging
DB_PORTNoPostgreSQL port for audit logging (e.g., 5432)
DB_TYPENoDatabase type for audit logging (e.g., postgres)
DB_USERNoPostgreSQL user for audit logging
DB_SCHEMANoPostgreSQL schema for audit logging (default: public)
DB_PASSWORDNoPostgreSQL password for audit logging
MCP_HTTP_HOSTNoHost to bind HTTP server (default: 0.0.0.0)
MCP_HTTP_PORTNoPort for HTTP server (default: 3000)
METABASE_PASSNoMetabase password for service account (alternative to METABASE_API_KEY)
METABASE_USERNoMetabase username for service account authentication
AUDIT_LOG_TABLENoTable name for audit logs (default: app_data_mcp_audit_logs)
POSTHOG_API_KEYNoCompatibility alias for POSTHOG_PERSONAL_API_KEY (not recommended)
DATA_ASSETS_FILENoPath to the local assets JSON file (default: config/assets.json)
METABASE_API_KEYNoMetabase API key for service account authentication
POSTHOG_BASE_URLNoBase URL of the PostHog instance
AUDIT_LOG_ENABLEDNoEnable audit logging to database (true/false)
METABASE_BASE_URLNoBase URL of the Metabase instance
METABASE_PASSWORDNoCompatibility alias for METABASE_PASS
METABASE_USERNAMENoCompatibility alias for METABASE_USER
METABASE_AUTH_MODENoMetabase authentication mode (e.g., user-session)
METABASE_LOGIN_URLNoLogin URL for user session authentication
POSTHOG_PROJECT_IDNoPostHog project ID
APP_DATA_SESSION_FILENoPath to store Metabase sessions (default: .data/metabase-sessions.json)
DATA_MAX_SEARCH_LIMITNoMaximum number of search results (default: 50)
MCP_HTTP_BEARER_TOKENNoShared HTTP bearer token for server protection
DATA_MAX_RESPONSE_BYTESNoMaximum response size in bytes (default: 1000000)
DATA_MAX_DASHBOARD_CARDSNoMaximum number of cards to execute when fetching a dashboard
POSTHOG_PERSONAL_API_KEYNoPostHog Personal API key (recommended)
DATA_DEFAULT_SEARCH_LIMITNoDefault number of search results returned (default: 10)
DATA_MAX_RESULT_ROW_LIMITNoMaximum result rows allowed for run_asset (default: 500)
METABASE_SESSION_TTL_HOURSNoTime-to-live for stored Metabase sessions in hours (default: 168)
APP_DATA_REQUIRE_AUTH_TOKENNoIf true, all data tools require a valid user personal token; set to 'true' or 'false'
APP_DATA_MCP_PUBLIC_BASE_URLNoMCP public base URL for redirect after Metabase login, e.g., http://127.0.0.1:3000
DATA_DEFAULT_RESULT_ROW_LIMITNoDefault number of result rows for run_asset (default: 100)
METABASE_ALLOW_SERVICE_FALLBACKNoAllow fallback to service account if no user session (true/false)

Capabilities

Features and capabilities supported by this server

CapabilityDetails
tools
{
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
search_assetsB

Search local metadata for Metabase dashboards/cards, PostHog insights, metrics, tables, and events.

get_assetB

Get full metadata for one data asset, including source URL, query text, columns, children, and warnings.

trace_assetB

Trace where a data asset comes from, including upstream tables/events/assets and original platform links.

run_assetC

Return read-only live data for a supported Metabase/PostHog asset, with local sampleData fallback.

list_domainsB

List business domains found in the local metadata config.

catalog_statusA

Show whether the local asset catalog is initialized and how many assets it contains.

auth_statusA

Check the current MCP request user and Metabase authorization status. Call this before run_asset for Metabase assets.

connector_statusA

Show whether Metabase and PostHog connector environment variables are configured. Secrets are never returned.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/jedshen123/app-data-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server