README.md•10.6 kB
# GoPluto MCP — Up‑to‑date Service Knowledge & Snippets in Any Prompt
[](https://gopluto.ai) [](#)[](https://lobehub.com/mcp/gopluto-ai-gopluto-ai-mcp) [](./LICENSE)
[](https://cursor.com/en/install-mcp?name=gopluto&config=eyJ1cmwiOiJodHRwczovL2FwaS5nb3BsdXRvLmFpL21jcCIsImhlYWRlcnMiOnsiZ29wbHV0by1hcGkta2V5IjoiWU9VUl9BUElfS0VZIn19)
[<img alt="Install in Cursor (Local proxy)" src="https://img.shields.io/badge/Cursor-Install%20Local%20Proxy-0098FF?style=for-the-badge&logo=visualstudiocode&logoColor=white">](https://cursor.com/en/install-mcp?name=gopluto&config=eyJjb21tYW5kIjoidXYiLCJhcmdzIjpbInJ1biIsInB5dGhvbjMiLCIvQUJTT0xVVEUvUEFUSC9UTy9nb3BsdXRvLW1jcC9tYWluLnB5Il0sImVudiI6eyJHT1BMVVRPX01DUF9VUkwiOiJodHRwczovL2FwaS5nb3BsdXRvLmFpL21jcCIsIkdPUExVVE9fQVVUSF9IRUFERVIiOiJnb3BsdXRvLWFwaS1rZXkiLCJHT1BMVVRPX0FQSV9LRVkiOiJZT1VSX0FQSV9LRVkiLCJHT1BMVVRPX1RSQU5TUE9SVCI6InNzZSJ9fQ%3D%3D)
> 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**
```txt
Draft a WhatsApp onboarding flow that asks for experts within minutes. use gopluto
```
```txt
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)**
[](https://cursor.com/en/install-mcp?name=gopluto&config=eyJ1cmwiOiJodHRwczovL2FwaS5nb3BsdXRvLmFpL21jcCIsImhlYWRlcnMiOnsiZ29wbHV0by1hcGkta2V5IjoiWU9VUl9BUElfS0VZIn19)
**Manual (Remote)**
```json
{
"mcpServers": {
"gopluto": {
"url": "https://api.gopluto.ai/mcp",
"headers": { "gopluto-api-key": "YOUR_API_KEY" }
}
}
}
```
**Local (stdio proxy)**
```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"
}
}
}
}
```
---
### Claude Code (CLI)
**Remote**
```sh
claude mcp add --transport http gopluto https://api.gopluto.ai/mcp \
--header "gopluto-api-key: YOUR_API_KEY"
```
**Local**
```sh
claude mcp add gopluto -- uv run python3 /ABSOLUTE/PATH/TO/gopluto-mcp/main.py
```
---
### Windsurf
**Remote**
```json
{
"mcpServers": {
"gopluto": {
"serverUrl": "https://api.gopluto.ai/mcp",
"headers": { "gopluto-api-key": "YOUR_API_KEY" }
}
}
}
```
**Local**
```json
{
"mcpServers": {
"gopluto": {
"command": "uv",
"args": ["run","python3","/ABSOLUTE/PATH/TO/gopluto-mcp/main.py"]
}
}
}
```
---
### VS Code (Copilot Chat MCP)
**Remote**
```json
"mcp": {
"servers": {
"gopluto": {
"type": "http",
"url": "https://api.gopluto.ai/mcp",
"headers": { "gopluto-api-key": "YOUR_API_KEY" }
}
}
}
```
**Local**
```json
"mcp": {
"servers": {
"gopluto": {
"type": "stdio",
"command": "uv",
"args": ["run","python3","/ABSOLUTE/PATH/TO/gopluto-mcp/main.py"]
}
}
}
```
---
### Cline
**Marketplace** → search **GoPluto** → **Install**
**Manual (Remote)**
```json
{
"mcpServers": {
"gopluto": {
"url": "https://api.gopluto.ai/mcp",
"type": "streamableHttp",
"headers": { "gopluto-api-key": "YOUR_API_KEY" }
}
}
}
```
---
### Zed
```json
{
"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**
```json
"augment.advanced": {
"mcpServers": [
{
"name": "gopluto",
"command": "uv",
"args": ["run","python3","/ABSOLUTE/PATH/TO/gopluto-mcp/main.py"]
}
]
}
```
---
### Roo Code
**Remote**
```json
{
"mcpServers": {
"gopluto": {
"type": "streamable-http",
"url": "https://api.gopluto.ai/mcp",
"headers": { "gopluto-api-key": "YOUR_API_KEY" }
}
}
}
```
**Local**
```json
{
"mcpServers": {
"gopluto": {
"command": "uv",
"args": ["run","python3","/ABSOLUTE/PATH/TO/gopluto-mcp/main.py"]
}
}
}
```
---
### Gemini CLI
**Remote**
```json
{
"mcpServers": {
"gopluto": {
"httpUrl": "https://api.gopluto.ai/mcp",
"headers": {
"gopluto-api-key": "YOUR_API_KEY",
"Accept": "application/json, text/event-stream"
}
}
}
}
```
**Local**
```json
{
"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`
```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**
```json
"mcp": {
"gopluto": {
"type": "remote",
"url": "https://api.gopluto.ai/mcp",
"headers": { "gopluto-api-key": "YOUR_API_KEY" },
"enabled": true
}
}
```
**Local**
```json
"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**
```json
{
"mcpServers": {
"gopluto": {
"command": "uv",
"args": ["run","python3","/ABSOLUTE/PATH/TO/gopluto-mcp/main.py"]
}
}
}
```
---
### Kiro
```json
{
"mcpServers": {
"GoPluto": {
"command": "uv",
"args": ["run","python3","/ABSOLUTE/PATH/TO/gopluto-mcp/main.py"],
"env": {},
"disabled": false,
"autoApprove": []
}
}
}
```
---
### Trae
**Remote**
```json
{
"mcpServers": {
"gopluto": { "url": "https://api.gopluto.ai/mcp" }
}
}
```
**Local**
```json
{
"mcpServers": {
"gopluto": {
"command": "uv",
"args": ["run","python3","/ABSOLUTE/PATH/TO/gopluto-mcp/main.py"]
}
}
}
```
---
### Bun / Deno (local)
**Bun**
```json
{
"mcpServers": {
"gopluto": {
"command": "bunx",
"args": ["uv","run","python3","/ABSOLUTE/PATH/TO/gopluto-mcp/main.py"]
}
}
}
```
**Deno**
```json
{
"mcpServers": {
"gopluto": {
"command": "deno",
"args": ["run","--allow-run","--allow-env","--allow-net","/ABSOLUTE/PATH/TO/gopluto-mcp/deno_shim.ts"]
}
}
}
```
---
### Docker (local HTTP)
`Dockerfile`
```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:
```bash
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**
```txt
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)
```bash
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**
```bash
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