# Upvote.club — MCP Apps

Interactive [MCP App](https://claude.com/docs/connectors/building/mcp-apps/getting-started) with an inline **task progress card** for `get_task_status`.

All 6 Public API tools are available; `get_task_status` renders a progress bar UI in Claude.

## Upvote Club MCP packages

| Package | Repository | Use case |
|---------|------------|----------|
| Core | [upvote-club-mcp-core](https://github.com/upvoteclub/upvote-club-mcp-core) | Shared MCP server library (6 tools) |
| Local | [upvote-club-mcp-local](https://github.com/upvoteclub/upvote-club-mcp-local) | Cursor, Claude Code, manual Claude Desktop (`stdio`) |
| MCPB | [upvote-club-mcp-mcpb](https://github.com/upvoteclub/upvote-club-mcp-mcpb) | Single-click Claude Desktop `.mcpb` install |
| Remote | [upvote-club-mcp-remote](https://github.com/upvoteclub/upvote-club-mcp-remote) | Claude.ai custom connector (Streamable HTTP) |
| **Apps** | **This repo** — [upvote-club-mcp-apps](https://github.com/upvoteclub/upvote-club-mcp-apps) | MCP Apps + inline task progress UI |

## Build & run

```bash
git clone https://github.com/upvoteclub/upvote-club-mcp-apps.git
cd upvote-club-mcp-apps
npm install
npm run build
UPVOTE_API_KEY=upv_... npm start
# → http://localhost:8788/mcp
```

Stdio (Claude Desktop dev config):

```bash
UPVOTE_API_KEY=upv_... npm run start:stdio
```

```json
{
  "mcpServers": {
    "upvote-club-apps": {
      "command": "node",
      "args": ["/ABS/PATH/upvote-club-mcp-apps/main.js", "--stdio"],
      "env": { "UPVOTE_API_KEY": "upv_..." }
    }
  }
}
```

## Test with tunnel

Expose `http://localhost:8788/mcp` via Cloudflare Tunnel and add as Claude.ai custom connector with `X-API-Key` header.

## UI design

Follows [MCP Apps design guidelines](https://claude.com/docs/connectors/building/mcp-apps/design-guidelines): inline card, Claude theme CSS variables, max 2 actions (Refresh).

## Tools (6)

`get_api_reference`, `list_platforms`, `create_task`, `get_task_status`, `delete_task`

Full reference: [API_REFERENCE.md](https://github.com/upvoteclub/upvote-club-mcp-core/blob/main/docs/API_REFERENCE.md)

## Related

- Core dependency: [@upvote-club/mcp-core](https://github.com/upvoteclub/upvote-club-mcp-core)
- HTTP-only connector without UI? → [upvote-club-mcp-remote](https://github.com/upvoteclub/upvote-club-mcp-remote)
- Claude Desktop bundle? → [upvote-club-mcp-mcpb](https://github.com/upvoteclub/upvote-club-mcp-mcpb)

## Privacy

Connects only to `https://api.upvote.club`. https://upvote.club/privacy-policy