Skip to main content
GET
Get MCP status

Authorizations

Authorization
string
header
required

Personal access token, sent as Authorization: Bearer <token>.

Path Parameters

app_id
string
required

ID of the app.

Response

The app's live MCP server.

The app's live MCP server.

active
boolean
default:false

Whether AI clients can use the server right now. It's false until the app is published, while it's unpublished or blocked, when the workspace has turned MCP off or requires oauth from a none server, and when a none server's app requires visitors to log in.

Example:

true

published
boolean
default:false

Whether a publish has put an MCP server live for the app.

Example:

true

endpoint
string | null

URL AI clients connect to, or null when the app has no address yet.

Example:

"https://my-crm-3c45a1f2.base44.app/api/mcp"

auth
enum<string> | null

How clients authenticate with the live server, or null when none is published. Either "oauth", where clients sign in, or "none", where anyone can call the public tools.

Available options:
none,
oauth
Example:

"oauth"

tools
AppMcpToolSummary · object[]

Tools the live server serves. A none server lists only its public tools.

effective_public_settings
string | null

Who can open the app after its next publish, once workspace SSO rules apply. A none server only works while this is public_without_login.

Example:

"public_with_login"

workspace_policy
string
default:allow

The workspace's rule for app MCP servers. Either "allow", "oauth_only", which stops none servers, or "disabled", which stops every server in the workspace.

Example:

"allow"