Model Context Protocol (MCP)

Pholio for AI Coding Agents

Pholio provides a standard Model Context Protocol (MCP) endpoint so autonomous coding agents (Cursor, Claude Desktop, Antigravity, Cline) can keep your showcase current as you build.

Raw agents.md llms.txt

Endpoint & Authentication

All MCP requests are served over HTTP Streamable POST requests with Bearer token authentication.

Endpoint: https://pholio.cc/api/mcp

Headers: Authorization: Bearer pholio_live_<prefix>_<secret>

Configuration Snippets

Cursor IDE

.cursor/mcp.json in workspace

{
  "mcpServers": {
    "pholio": {
      "url": "https://pholio.cc/api/mcp",
      "headers": {
        "Authorization": "Bearer pholio_live_<prefix>_<secret>"
      }
    }
  }
}

Claude Desktop

claude_desktop_config.json

{
  "mcpServers": {
    "pholio": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-proxy",
        "https://pholio.cc/api/mcp"
      ],
      "env": {
        "PHOLIO_API_KEY": "pholio_live_<prefix>_<secret>"
      }
    }
  }
}

Antigravity / Cline

mcp_settings.json

{
  "mcpServers": {
    "pholio": {
      "url": "https://pholio.cc/api/mcp",
      "headers": {
        "Authorization": "Bearer pholio_live_<prefix>_<secret>"
      }
    }
  }
}

Available MCP Tools

Tool Name	Parameters	Description
update_project	project_slug, summary?, tags?, live_url?, status?	Updates project metadata, technology tags, live URL, and active/archived status.
publish_showcase	project_slug, body (10..600 chars)	Publishes 1–3 concise sentences to the project's living showcase feed.
sync_readme	project_slug	Triggers automatic re-parsing and summary generation from the repository README.
upload_mockup	project_slug, file_base64, device ('browser' \| 'phone' \| 'tablet')	Uploads a base64 screenshot framed in an authentic device container.
get_stats	project_slug, days? (default: 7)	Retrieves privacy-first visitor counts and pulse telemetry for the project.
get_leaderboard	group_slug?	Retrieves activity scores, push frequency, and rankings for a hacker group.

Recommended Master Prompt

Include this in your workspace AGENTS.md or agent system prompt so your agent knows when to update your showcase.

### Living Showcase Integration
When you make meaningful changes or ship features in this repository:
1. Keep project metadata up to date using update_project.
2. Post a showcase update using publish_showcase with 1-3 factual, hype-free sentences.
3. If new UI screens are implemented, upload device-framed screenshots using upload_mockup.