frontal-mcp

Frontal MCP Server

Standalone MCP server for the Frontal public API (api.frontal.dev). Hybrid of curated typed tools plus spec-driven generic meta-tools covering ~450 operations from the vendored OpenAPI spec (openapi/public.v1.json).

Setup

1. Get an API key from Frontal Platform (frt_...).
2. Set env: export FRONTAL_API_KEY="your_api_key_here".
3. Start:

   # stdio (Claude Desktop / local)
   frontal-mcp-server --transport stdio
   
   # HTTP (web apps / multi-tenant hosting)
   frontal-mcp-server --transport http --port 3000
   

Claude Desktop config (claude_desktop_config.json):

{
  "mcpServers": {
    "frontal": {
      "command": "frontal-mcp-server",
      "args": ["--transport", "stdio"],
      "env": { "FRONTAL_API_KEY": "your_api_key_here" }
    }
  }
}

Configuration

Variable	Default	Notes
FRONTAL_API_KEY	-	Required for stdio only; never a fallback for HTTP
FRONTAL_BASE_URL	https://api.frontal.dev	Bare host; /v1/ is in the paths
FRONTAL_REGION	-	Region pin (x-frontal-region, e.g. iad, lhr, fra, sin)
FRONTAL_TOOLSETS	generic,ontology,data	Comma-separated; invalid values are rejected
FRONTAL_HTTP_ALLOWED_ORIGINS	- (none trusted)	CORS allowlist for HTTP transport; never *
MCP_LOG_LEVEL	info	`error

HTTP transport rules:

• Every MCP request must send per-request Authorization: Bearer frt_...; missing token is 401.
• Exception: unauthenticated GET /health always returns 200 {"status":"ok"}.
• CLI: -t/--transport stdio|http, -p/--port, -h/--host, -k/--api-key, -c/--config, -v/--verbose, --log-level.

Tools

Select via FRONTAL_TOOLSETS=generic,ontology,data.

Generic (spec-driven) — generic

• frontal_list_endpoints — browse API surface by tag/search.
• frontal_describe_endpoint — full parameter/body/response detail for one operation.
• frontal_call_endpoint — invoke any operation by operationId (or method + path), with optional auto-pagination.