Skip to main content
The Web Dashboard provides REST API endpoints for managing MCPs, reading documentation, and accessing Claudio’s context.

​
Base URL

http://localhost:8000

​
Authentication

No authentication required for local development.

​
Endpoints

​
List MCPs

GET /api/mcps
Returns all configured MCPs from cursor-config.json. Response
​
mcpServers
object
Object containing all configured MCP servers
Example Response 
{
  "mcpServers": {
    "github": {
      "url": "http://localhost:3000",
      "transport": {
        "type": "sse"
      }
    },
    "slack": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-slack"],
      "env": {
        "SLACK_BOT_TOKEN": "xoxb-...",
        "SLACK_TEAM_ID": "T..."
      }
    },
    "clickup": {
      "command": "npx",
      "args": ["-y", "@propherolabs/mcp-server-clickup"]
    }
  }
}

​
Check All MCPs Health

GET /api/mcps/health
Verifies the health status of all configured MCPs. Response
​
checked_at
string
ISO timestamp of when the health check was performed
​
mcps
array
Array of MCP health check results
​
name
string
MCP server name
​
status
string
Health status: ready, configured, warning, error, or unknown
​
message
string
Detailed status message
​
type
string
MCP type: remote, npx, python, node, or unknown
​
icon
string
Emoji icon for the MCP
​
checked_at
string
ISO timestamp of the check
Example Response 
{
  "checked_at": "2026-02-28T10:30:00.123456",
  "mcps": [
    {
      "name": "github",
      "status": "configured",
      "message": "Remote MCP configured: http://localhost:3000",
      "type": "remote",
      "icon": "🐙",
      "checked_at": "2026-02-28T10:30:00.123456"
    },
    {
      "name": "slack",
      "status": "ready",
      "message": "npx package: @modelcontextprotocol/server-slack",
      "type": "npx",
      "icon": "💬",
      "checked_at": "2026-02-28T10:30:00.234567"
    },
    {
      "name": "clickup",
      "status": "ready",
      "message": "npx package: @propherolabs/mcp-server-clickup",
      "type": "npx",
      "icon": "✅",
      "checked_at": "2026-02-28T10:30:00.345678"
    }
  ]
}

​
Check Single MCP Health

GET /api/mcps/{mcp_name}/health
Verifies the health status of a specific MCP. Path Parameters
​
mcp_name
string
required
Name of the MCP to check (e.g., github, slack, clickup)
Response
​
name
string
MCP server name
​
status
string
Health status: ready, configured, warning, error, or unknown
​
message
string
Detailed status message
​
type
string
MCP type: remote, npx, python, node, or unknown
​
icon
string
Emoji icon for the MCP
​
checked_at
string
ISO timestamp of the check
Example Response 
{
  "name": "github",
  "status": "configured",
  "message": "Remote MCP configured: http://localhost:3000",
  "type": "remote",
  "icon": "🐙",
  "checked_at": "2026-02-28T10:30:00.123456"
}
Error Response (404) 
{
  "detail": "MCP 'unknown-mcp' not found"
}

​
Get Documentation List

GET /api/docs/{doc_type}
Returns a list of available documentation files. Path Parameters
​
doc_type
string
required
Type of documentation: integrations or workflows
Response for Integrations
​
integrations
array
Array of integration documentation
​
name
string
Integration name
​
path
string
Relative path to the guide file
​
has_config
boolean
Whether the integration has a config.md file
Example Response 
[
  {
    "name": "clickup",
    "path": "docs/integrations/clickup/guide.md",
    "has_config": true
  },
  {
    "name": "github",
    "path": "docs/integrations/github/guide.md",
    "has_config": false
  },
  {
    "name": "slack",
    "path": "docs/integrations/slack/guide.md",
    "has_config": false
  }
]
Response for Workflows
​
workflows
array
Array of workflow documentation
​
name
string
Workflow name (formatted title)
​
path
string
Relative path to the workflow file
​
filename
string
Original filename
Example Response 
[
  {
    "name": "Create Initiative",
    "path": "docs/workflows/create-initiative.md",
    "filename": "create-initiative.md"
  },
  {
    "name": "Daily Standup",
    "path": "docs/workflows/daily-standup.md",
    "filename": "daily-standup.md"
  },
  {
    "name": "Sprint Report",
    "path": "docs/workflows/sprint-report.md",
    "filename": "sprint-report.md"
  }
]

​
Read Documentation File

GET /api/docs/read?path={file_path}
Reads the contents of a documentation file. Query Parameters
​
path
string
required
Relative path to the documentation file (must be within docs/ directory)
Response
​
path
string
The requested file path
​
content
string
The file contents
Example Request 
GET /api/docs/read?path=docs/workflows/daily-standup.md
Example Response 
{
  "path": "docs/workflows/daily-standup.md",
  "content": "# Daily Standup\n\n## Overview\n..."
}
Error Responses 
// 403 - Path outside docs/ directory
{
  "detail": "Access denied"
}

// 404 - File not found
{
  "detail": "File not found"
}

​
Get Claudio Context

GET /api/context
Returns the contents of CLAUDE.md (Claudio’s main context file). Response
​
path
string
Always CLAUDE.md
​
content
string
The complete CLAUDE.md file contents
Example Response 
{
  "path": "CLAUDE.md",
  "content": "# Claudio - Asistente de Productividad PropHero\n\nEres **Claudio**..."
}

​
HTML Pages

​
Dashboard

GET /
Main dashboard page showing MCPs, integrations, and workflows.

​
Chat Page

GET /chat
Full-screen chat interface with Claudio (uses WebSocket connection).

​
Configuration

The web dashboard is configured via environment variables: 
CLAUDE_CLI_PATH=claude              # Path to Claude Code CLI
WORKSPACE_PATH=/path/to/workspace   # Working directory
COMMAND_TIMEOUT=1800                # Command timeout in seconds
SKIP_PERMISSIONS=true               # Skip permission prompts
See /channels/web/.env.example for complete configuration options.

Build docs developers (and LLMs) love

Get started for freeTalk to us