GoPluto MCP — Up‑to‑date Service Knowledge & Snippets in Any Prompt

GoPluto MCP lets AI coding assistants pull fresh service/provider knowledge, routing rules, and ready‑to‑paste snippets from GoPluto — right inside your prompt.

---

❌ Without GoPluto

• ❌ No guarantee of finding the right expert when you actually need them
• ❌ Made-up providers and broken flows waste time
• ❌ Constant context-switching between people slows you down

✅ With GoPluto

Add use gopluto in your prompt (or set a rule once) and the assistant fetches live GoPluto context:

• Fresh, verified provider knowledge pulled directly into your prompt
• instant provider matching hints & filters
• minimal payloads & code snippets for expert access in minutes

Examples

Draft a WhatsApp onboarding flow that asks for experts within minutes. use gopluto

Show me the minimal payload to create a Service Request and start matching experts in under 60 seconds. use gopluto

---

🛠️ Installation

Requirements

• Any MCP‑capable client (Cursor, Claude Code, VS Code, Windsurf, Zed, etc.)
• GoPluto API Key (keep client‑side)
• Network access to https://api.gopluto.ai/mcp

Auth header: gopluto-api-key: YOUR_API_KEY

If your client can’t attach headers to remote servers, use the included local stdio proxy (main.py) to add the header for you.

---

Cursor

One‑click (Remote HTTP)

Manual (Remote)

{
  "mcpServers": {
    "gopluto": {
      "url": "https://api.gopluto.ai/mcp",
      "headers": { "gopluto-api-key": "YOUR_API_KEY" }
    }
  }
}

Local (stdio proxy)

{
  "mcpServers": {
    "gopluto": {
      "command": "uv",
      "args": ["run","python3","/ABSOLUTE/PATH/TO/gopluto-mcp/main.py"],
      "env": {
        "GOPLUTO_MCP_URL": "https://api.gopluto.ai/mcp",
        "GOPLUTO_AUTH_HEADER": "gopluto-api-key",
        "GOPLUTO_API_KEY": "YOUR_API_KEY",
        "GOPLUTO_TRANSPORT": "sse"
      }
    }
  }
}

---

Claude Code (CLI)

Remote

claude mcp add --transport http gopluto https://api.gopluto.ai/mcp \
  --header "gopluto-api-key: YOUR_API_KEY"

Local

claude mcp add gopluto -- uv run python3 /ABSOLUTE/PATH/TO/gopluto-mcp/main.py

---

Windsurf

Remote

{
  "mcpServers": {
    "gopluto": {
      "serverUrl": "https://api.gopluto.ai/mcp",
      "headers": { "gopluto-api-key": "YOUR_API_KEY" }
    }
  }
}

Local

{
  "mcpServers": {
    "gopluto": {
      "command": "uv",
      "args": ["run","python3","/ABSOLUTE/PATH/TO/gopluto-mcp/main.py"]
    }
  }
}

---

VS Code (Copilot Chat MCP)

Remote

"mcp": {
  "servers": {
    "gopluto": {
      "type": "http",
      "url": "https://api.gopluto.ai/mcp",
      "headers": { "gopluto-api-key": "YOUR_API_KEY" }
    }
  }
}

Local

"mcp": {
  "servers": {
    "gopluto": {
      "type": "stdio",
      "command": "uv",
      "args": ["run","python3","/ABSOLUTE/PATH/TO/gopluto-mcp/main.py"]
    }
  }
}

---

Cline

Marketplace → search GoPluto → Install

Manual (Remote)

{
  "mcpServers": {
    "gopluto": {
      "url": "https://api.gopluto.ai/mcp",
      "type": "streamableHttp",
      "headers": { "gopluto-api-key": "YOUR_API_KEY" }
    }
  }
}

---

Zed

{
  "context_servers": {
    "GoPluto": {
      "command": {
        "path": "uv",
        "args": ["run","python3","/ABSOLUTE/PATH/TO/gopluto-mcp/main.py"]
      }
    }
  }
}

---

Augment Code

UI → Settings → Tools → + Add MCP → Command:

uv run python3 /ABSOLUTE/PATH/TO/gopluto-mcp/main.py

Manual

"augment.advanced": {
  "mcpServers": [
    {
      "name": "gopluto",
      "command": "uv",
      "args": ["run","python3","/ABSOLUTE/PATH/TO/gopluto-mcp/main.py"]
    }
  ]
}

---

Roo Code

Remote

{
  "mcpServers": {
    "gopluto": {
      "type": "streamable-http",
      "url": "https://api.gopluto.ai/mcp",
      "headers": { "gopluto-api-key": "YOUR_API_KEY" }
    }
  }
}

Local

{
  "mcpServers": {
    "gopluto": {
      "command": "uv",
      "args": ["run","python3","/ABSOLUTE/PATH/TO/gopluto-mcp/main.py"]
    }
  }
}

---

Gemini CLI

Remote

{
  "mcpServers": {
    "gopluto": {
      "httpUrl": "https://api.gopluto.ai/mcp",
      "headers": {
        "gopluto-api-key": "YOUR_API_KEY",
        "Accept": "application/json, text/event-stream"
      }
    }
  }
}

Local

{
  "mcpServers": {
    "gopluto": {
      "command": "uv",
      "args": ["run","python3","/ABSOLUTE/PATH/TO/gopluto-mcp/main.py"]
    }
  }
}

---

Claude Desktop

Remote: Settings → Connectors → Add Custom Connector
URL: https://api.gopluto.ai/mcp
Header: gopluto-api-key: YOUR_API_KEY

Local: Developer settings → edit claude_desktop_config.json

{
  "mcpServers": {
    "gopluto": {
      "command": "uv",
      "args": ["run","python3","/ABSOLUTE/PATH/TO/gopluto-mcp/main.py"],
      "env": {
        "GOPLUTO_MCP_URL": "https://api.gopluto.ai/mcp",
        "GOPLUTO_AUTH_HEADER": "gopluto-api-key",
        "GOPLUTO_API_KEY": "YOUR_API_KEY",
        "GOPLUTO_TRANSPORT": "sse"
      }
    }
  }
}

---

Opencode

Remote

"mcp": {
  "gopluto": {
    "type": "remote",
    "url": "https://api.gopluto.ai/mcp",
    "headers": { "gopluto-api-key": "YOUR_API_KEY" },
    "enabled": true
  }
}

Local

"mcp": {
  "gopluto": {
    "type": "local",
    "command": ["uv","run","python3","/ABSOLUTE/PATH/TO/gopluto-mcp/main.py"],
    "enabled": true
  }
}

---

JetBrains AI Assistant

Settings → Tools → AI Assistant → Model Context Protocol (MCP) → + Add → As JSON

{
  "mcpServers": {
    "gopluto": {
      "command": "uv",
      "args": ["run","python3","/ABSOLUTE/PATH/TO/gopluto-mcp/main.py"]
    }
  }
}

---

Kiro

{
  "mcpServers": {
    "GoPluto": {
      "command": "uv",
      "args": ["run","python3","/ABSOLUTE/PATH/TO/gopluto-mcp/main.py"],
      "env": {},
      "disabled": false,
      "autoApprove": []
    }
  }
}

---

Trae

Remote

{
  "mcpServers": {
    "gopluto": { "url": "https://api.gopluto.ai/mcp" }
  }
}

Local

{
  "mcpServers": {
    "gopluto": {
      "command": "uv",
      "args": ["run","python3","/ABSOLUTE/PATH/TO/gopluto-mcp/main.py"]
    }
  }
}

---

Bun / Deno (local)

Bun

{
  "mcpServers": {
    "gopluto": {
      "command": "bunx",
      "args": ["uv","run","python3","/ABSOLUTE/PATH/TO/gopluto-mcp/main.py"]
    }
  }
}

Deno

{
  "mcpServers": {
    "gopluto": {
      "command": "deno",
      "args": ["run","--allow-run","--allow-env","--allow-net","/ABSOLUTE/PATH/TO/gopluto-mcp/deno_shim.ts"]
    }
  }
}

---

Docker (local HTTP)

Dockerfile

FROM python:3.11-slim
WORKDIR /app
COPY requirements.txt main.py ./
RUN pip install --no-cache-dir -r requirements.txt
ENV GOPLUTO_MCP_URL=https://api.gopluto.ai/mcp \
    GOPLUTO_AUTH_HEADER=gopluto-api-key \
    GOPLUTO_TRANSPORT=sse
EXPOSE 12006
CMD ["python","main.py","--mode","http","--host","0.0.0.0","--port","12006"]

Run:

docker build -t gopluto-mcp .
docker run --rm -p 12006:12006 -e GOPLUTO_API_KEY=YOUR_API_KEY gopluto-mcp

Point your client to http://localhost:12006.

---

Windows notes

If paths/quoting are tricky, use cmd /c or PowerShell; prefer absolute paths for command and args.

---

🔧 Available Tools (examples)

• resolve-gopluto-id – Resolve a package/service name to a GoPluto ID
• get-gopluto-docs – Fetch docs/snippets for a GoPluto ID
• search-providers – Query providers by skills/geo/budget
• create-service-request – Minimal payload helper

(Your upstream server’s tool list may evolve; use your client’s tool inspector to list them.)

---

🛟 Tips

Add a Rule to auto‑use GoPluto

Always use gopluto when I ask for service matching, onboarding flows, or API payloads.
Automatically call GoPluto MCP tools to resolve IDs and fetch snippets.

HTTPS Proxy: standard HTTPS_PROXY / https_proxy env variables apply.

---

💻 Development (local proxy)

uv pip install -r requirements.txt
export GOPLUTO_API_KEY="YOUR_REAL_KEY"
uv run python3 main.py               # stdio (default)
# or:
uv run python3 main.py --mode http --port 12006

Smoke test remote server

curl -X POST "https://api.gopluto.ai/mcp" \
  -H "Content-Type: application/json" \
  -H "gopluto-api-key: $GOPLUTO_API_KEY" \
  -d '{"jsonrpc":"2.0","id":"1","method":"initialize","params":{"protocolVersion":"2025-06-18"}}'

---

🚨 Troubleshooting

• 401/403 → wrong/missing gopluto-api-key
• Client can’t add headers → use local stdio proxy
• TLS issues → set SSL_CERT_FILE for Python
• Module not found (Node) → prefer Python proxy (no Node needed)

---

📄 License

MIT