# mcp

mcp connects Capawesome documentation and Capawesome Cloud controls directly to your AI client. Helps look up mobile plugin docs and trigger cloud builds.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 2 repo stars
- Author: capawesome-team
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/capawesome-team/mcp
- Updated: 2026-09-08
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/capawesome-team-mcp

## What it does

This server exposes official documentation for Capawesome plugins and developer guides. Reading reference articles does not require any account. The client queries `search_docs`, `get_doc_page`, and `list_blog_posts` directly via the hosted endpoint `https://mcp.capawesome.io/mcp`.

Capawesome Cloud administration commands depend on a valid API key. Without a token, cloud management tools remain completely unregistered rather than hidden. Once you pass your secret in the `Authorization: Bearer` header or the `CAPAWESOME_TOKEN` variable, the server registers the `cloud_*` set. Setting `?readonly=true` blocks any mutating action.

Traffic is capped at 100 requests per minute per IP address. Exceeding this rate triggers a `429 Too Many Requests` response. For environments lacking remote HTTP transport, the `@capawesome/mcp` package runs locally as a proxy. It requires Node.js 22 or newer.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://mcp.capawesome.io/mcp`

## Install

### Claude Code (native platform)

1. **Platform CLI: remote server**
```bash
claude mcp add --transport http mcp https://mcp.capawesome.io/mcp
```

2. **Platform CLI**
```bash
claude mcp add capawesome-team-mcp -- npx -y @capawesome/mcp
```

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add capawesome-team-mcp --url https://mcp.capawesome.io/mcp
```

2. **Platform CLI**
```bash
codex mcp add capawesome-team-mcp -- npx -y @capawesome/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "capawesome-team-mcp": {
            "url": "https://mcp.capawesome.io/mcp"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "capawesome-team-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@capawesome/mcp"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "capawesome-team-mcp": {
            "type": "http",
            "url": "https://mcp.capawesome.io/mcp"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "capawesome-team-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@capawesome/mcp"
            ]
        }
    }
}
```

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http capawesome-team-mcp https://mcp.capawesome.io/mcp
```

2. **Platform CLI**
```bash
gemini mcp add capawesome-team-mcp npx -y @capawesome/mcp
```

## When to use it
- browse Capawesome and Capacitor plugin documentation within your editor
- retrieve code snippets from official guides and blog posts
- trigger mobile application builds via Capawesome Cloud
- monitor update channels and deployments directly from chat

## Example prompts
- Look up how to configure the biometric plugin in the Capawesome docs.
- List recent builds for my project in Capawesome Cloud.
- Find the required configuration options for live updates in Capawesome.

## Similar
- [capawesome-mcp](https://affpapa.org/en/nevibecode/skills/capawesome-mcp.md) — skill · 965 installs
- [capacitor-mcp](https://affpapa.org/en/nevibecode/mcp/capacitor-mcp.md) — MCP server · ★ 1 repo stars
- [Chinaready China Market-Entry Search](https://affpapa.org/en/nevibecode/mcp/chinaready-china-market-entry-search.md) — MCP server
- [open-wrap-url](https://affpapa.org/en/nevibecode/skills/open-wrap-url.md) — skill · ★ 1167 repo stars
- [capacitor-best-practices](https://affpapa.org/en/nevibecode/skills/capacitor-best-practices.md) — skill · 2900 installs
- [capacitor-plugins](https://affpapa.org/en/nevibecode/skills/cap-go-capacitor-plugins.md) — skill · 1700 installs

## Other versions with the same name
- [mcp · kubeshark](https://affpapa.org/en/nevibecode/mcp/kubeshark-mcp.md) — ★ 12142 repo stars
- [mcp · butterbase-ai](https://affpapa.org/en/nevibecode/mcp/butterbase-ai-mcp.md) — ★ 3033 repo stars
- [mcp · medplum](https://affpapa.org/en/nevibecode/mcp/mcp.md) — ★ 2812 repo stars
- [mcp · sceneview](https://affpapa.org/en/nevibecode/mcp/sceneview-mcp.md) — ★ 1379 repo stars
- [mcp · buoy-gg](https://affpapa.org/en/nevibecode/mcp/buoy-gg-mcp.md) — ★ 696 repo stars

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
