Skip to content
Download Beeper

Get Connect server info

info.retrieve() -> InfoRetrieveResponse
GET/v1/info

Returns app, platform, server, and endpoint discovery metadata for this Beeper Desktop instance.

ReturnsExpand Collapse
class InfoRetrieveResponse:
app: App
bundle_id: str

App bundle identifier

name: str

App name

version: str

App version

endpoints: Endpoints
mcp: str

MCP endpoint

oauth: EndpointsOAuth
authorization_endpoint: str

OAuth authorization endpoint

introspection_endpoint: str

OAuth introspection endpoint

registration_endpoint: str

OAuth dynamic client registration endpoint

revocation_endpoint: str

OAuth token revocation endpoint

token_endpoint: str

OAuth token endpoint

userinfo_endpoint: str

OAuth userinfo endpoint

spec: str

OpenAPI spec endpoint

ws_events: str

WebSocket events endpoint

platform: Platform
arch: str

CPU architecture

os: str

Operating system identifier

release: Optional[str]

Runtime release version

server: Server
base_url: str

Base URL of the Connect server

hostname: str

Listening host

mcp_enabled: bool

Whether MCP endpoint is enabled

port: int

Listening port

remote_access: bool

Whether remote access is enabled

status: str

Server status

Get Connect server info

from beeper_desktop_api import BeeperDesktop

client = BeeperDesktop()
info = client.info.retrieve()
print(info.app)
{
  "app": {
    "bundle_id": "bundle_id",
    "name": "name",
    "version": "version"
  },
  "endpoints": {
    "mcp": "mcp",
    "oauth": {
      "authorization_endpoint": "authorization_endpoint",
      "introspection_endpoint": "introspection_endpoint",
      "registration_endpoint": "registration_endpoint",
      "revocation_endpoint": "revocation_endpoint",
      "token_endpoint": "token_endpoint",
      "userinfo_endpoint": "userinfo_endpoint"
    },
    "spec": "spec",
    "ws_events": "ws_events"
  },
  "platform": {
    "arch": "arch",
    "os": "os",
    "release": "release"
  },
  "server": {
    "base_url": "base_url",
    "hostname": "hostname",
    "mcp_enabled": true,
    "port": 0,
    "remote_access": true,
    "status": "status"
  }
}
Returns Examples
{
  "app": {
    "bundle_id": "bundle_id",
    "name": "name",
    "version": "version"
  },
  "endpoints": {
    "mcp": "mcp",
    "oauth": {
      "authorization_endpoint": "authorization_endpoint",
      "introspection_endpoint": "introspection_endpoint",
      "registration_endpoint": "registration_endpoint",
      "revocation_endpoint": "revocation_endpoint",
      "token_endpoint": "token_endpoint",
      "userinfo_endpoint": "userinfo_endpoint"
    },
    "spec": "spec",
    "ws_events": "ws_events"
  },
  "platform": {
    "arch": "arch",
    "os": "os",
    "release": "release"
  },
  "server": {
    "base_url": "base_url",
    "hostname": "hostname",
    "mcp_enabled": true,
    "port": 0,
    "remote_access": true,
    "status": "status"
  }
}