SmartGate MCP server

SmartGate

AI Intelligence Layer — not another assistant or LLM proxy.

Official SmartGate plugin for Cursor, Claude Code, claude.ai, and Cowork.

SmartGate is the intelligence layer between AI and the world — helping you research, understand, remember, and act before runaway tool traffic becomes a surprise invoice.

On the surface: Smart Research, decisions, knowledge, and monitoring — no MCP required. Under the hood: an MCP-native algorithmic gateway with five capabilities (Research, Context, Memory, Control, Pipeline) powered by seven smart_* primitives. Human interface (Web) + agent interface (MCP/API). Not a chatbot, search app, or model router. The host model stays on the client.

Plugin mark for Cursor Marketplace is the 1:1 shield assets/logo.png. The banner is the official site OG card. The research demo is the same GIF as the homepage.

What is SmartGate MCP

Don't rebuild research infrastructure for every agent. Connect once over Streamable HTTP; the gateway fetches, searches, compresses, deduplicates, remembers, and hard-caps tool traffic before it reaches your model provider.

Capability	What the agent does	Product
Research	Find sources, then read pages as Markdown	Traffic Customs
Context	Dedup overlapping hits, then compress	Token Control
Memory	Persist and recall team facts across sessions	Features
Control	Check, count, and cap token budget	Token Control
Pipeline	Run research / read / remember as one job	Tools

• Product: smartgate.network · Features · Pricing
• Connect: Quick start · Connect · MCP endpoint
• Reference: Tools · Security · llms.txt
• Compliance: Audit · Privacy · Terms

Install

Mint a key at Dashboard → API Keys (sk_live_…). Never paste the key into chat or commit it.

Official MCP Registry name: network.smartgate/smartgate. Same endpoint: https://smartgate.network/api/mcp. The listing is metadata only — you still need the Dashboard Bearer key.

Cursor

1. Install SmartGate from the Cursor Marketplace, or import this repo under Cursor Dashboard → Plugins → Team Marketplaces → Import from Repo: https://github.com/smartgate-network/smartgate-workflows
2. Open Plugins → SmartGate → Configure and set SMARTGATE_API_KEY
3. Restart Cursor (or reload the window) so the MCP handshake runs again

Claude (claude.ai / Cowork / Claude Code)

1. Add SmartGate from Anthropic's directory, or load this repo locally: claude --plugin-dir .
2. When Claude prompts for plugin configuration, set SMARTGATE_API_KEY. In Claude Code you can also run /plugin configure @smartgate
3. Confirm the connector: on claude.ai / Cowork use the plugin's Connectors tab; in Claude Code run /mcp and look for plugin:smartgate:smartgate

Gemini CLI

gemini extensions install https://github.com/smartgate-network/smartgate-workflows

Set SMARTGATE_API_KEY when the CLI prompts. Manifest: gemini-extension.json.

OpenClaw

Install the ClawHub skill, then add the hosted MCP:

openclaw skills install @smartgate.network/smartgate

Connect: Settings → MCP → Add server (Streamable HTTP, https://smartgate.network/api/mcp, Authorization: Bearer ${SMARTGATE_API_KEY}). Skill source: skills/smartgate/SKILL.md.

Hermes

From the Hermes MCP catalog:

hermes mcp install smartgate

Paste the Dashboard sk_live_… key when prompted (MCP_SMARTGATE_API_KEY).

Or add the hosted server in ~/.hermes/config.yaml and the key in ~/.hermes/.env:

mcp_servers:
  smartgate:
    url: "https://smartgate.network/api/mcp"
    headers:
      Authorization: "Bearer ${SMARTGATE_API_KEY}"
      X-SmartGate-Agent-Platform: hermes

Skill (ClawHub):

hermes skills search smartgate --source clawhub
hermes skills install clawhub/smartgate.network/smartgate

Or add this repo as a skill tap: hermes skills tap add smartgate-network/smartgate-workflows.

AutoGPT

From AutoGPT's hosted MCP catalog, select SmartGate and paste the Dashboard sk_live_… key as the access token. Paste the key only — the client adds Bearer.

Or add an MCP Tool block: URL https://smartgate.network/api/mcp, auth Bearer, access token = Dashboard API key.

Zed

Settings → AI → MCP Servers → Add Server → Add Remote Server:

{
  "context_servers": {
    "smartgate": {
      "url": "https://smartgate.network/api/mcp",
      "headers": {
        "Authorization": "Bearer ${SMARTGATE_API_KEY}",
        "X-SmartGate-Agent-Platform": "zed"
      }
    }
  }
}

Or install from Zed MCP extensions if SmartGate is listed there.

VS Code / GitHub Copilot

Command Palette → MCP: Add Server → HTTP. URL https://smartgate.network/api/mcp. Set header Authorization = Bearer ${SMARTGATE_API_KEY}.

Or browse the gallery: Extensions view → search @mcp smartgate.

OpenCode

Add a remote MCP in OpenCode config:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "smartgate": {
        "type": "remote",
        "url": "https://smartgate.network/api/mcp",
        "oauth": false,
        "headers": {
          "Authorization": "Bearer {env:SMARTGATE_API_KEY}",
          "X-SmartGate-Agent-Platform": "opencode"
        }
      }
    }
  }
}

Goose

Add a Streamable HTTP extension: URL https://smartgate.network/api/mcp, header Authorization: Bearer ${SMARTGATE_API_KEY}, X-SmartGate-Agent-Platform: goose. Skill source: skills/smartgate/SKILL.md.

Kilo Code

Install from the Kilo Marketplace, or connect the hosted MCP the same way as Cline — see llms-install.md.

Crush

Add a remote Streamable HTTP MCP in Crush config. URL https://smartgate.network/api/mcp, header Authorization: Bearer ${SMARTGATE_API_KEY}.

Cherry Studio

Settings → MCP → MCP Servers → Add. Import from JSON (type must be streamableHttp) or Quick Create → Streamable HTTP:

{
  "mcpServers": {
    "smartgate": {
      "type": "streamableHttp",
      "url": "https://smartgate.network/api/mcp",
      "headers": {
        "Authorization": "Bearer ${SMARTGATE_API_KEY}"
      }
    }
  }
}

Enable the server, then Work → Agent → Edit → MCP and bind it.

AnythingLLM

Settings → Agent Skills, or edit plugins/anythingllm_mcp_servers.json (type is streamable, not streamable-http):

{
  "mcpServers": {
    "smartgate": {
      "type": "streamable",
      "url": "https://smartgate.network/api/mcp",
      "headers": {
        "Authorization": "Bearer ${SMARTGATE_API_KEY}"
      }
    }
  }
}

Reload MCP servers in the UI, start SmartGate, then enable its tools for the workspace.

Other MCP clients (LibreChat, Open WebUI, Dify, Langflow, Flowise, n8n)

Any host that supports remote Streamable HTTP can connect with:

• URL: https://smartgate.network/api/mcp
• Header: Authorization: Bearer ${SMARTGATE_API_KEY}
• Official Registry name: network.smartgate/smartgate

First run

After the MCP server shows as connected, try:

Check my SmartGate token allowance with smart_budget_guard action=check.

smart_fetch https://smartgate.network/docs/tools then summarize Token Control, Traffic Customs, and Audit.

Remember: our staging API rate limit is 100 req/min

Live tools/list schemas (purpose, params, returns) come from the hosted server, not this repo. Names are smart_* — there is no smartgate_compress_context. Full reference: Docs → Tools.

Tools (reviewer cheat sheet)

Every tool returns a JSON string. Parse it before synthesizing. Do not invent page content.

Tool	Required	Optional	Returns
smart_search	query	max_results (1–50, default 10)	Search hits (results[].url, snippet)
smart_fetch	url (http/https)	timeout (default 30s)	Page markdown, title, url
smart_dedup	texts (string[])	threshold (0–1, default 0.9)	Kept / removed indices or deduped texts
smart_context_gate	text	ratio (default 0.5), purpose	compressed, ratio, token counts
smart_budget_guard	action: check | count | record	text / tokens by action	Allowance, usage, or record ack
smart_memory	action: add | search | get | delete	text (add), query (search), memory_id (get/delete)	Shape depends on action
smart_pipe	template or steps	query, url, text	Per-step results. Templates: research, read, remember. Not for a single step.

Skills shipped with this plugin:

Skill	Routes
smartgate-workflows	Pick the right workflow
smartgate-research-agent	Multi-source research
smartgate-deep-reading	One known URL
smartgate-remember-and-recall	Team memory
smartgate-usage-report	Quota / usage (no content)

Configure

Cursor Marketplace: Plugins → SmartGate → Configure → SMARTGATE_API_KEY. Cursor reads mcp.json (${SMARTGATE_API_KEY}).

Claude directory / Claude Code: /plugin configure @smartgate → SMARTGATE_API_KEY. Claude reads .mcp.json (${user_config.SMARTGATE_API_KEY}). Do not commit a real key.

Manual / reviewer fallback (only if you are not using the plugin): merge this into ~/.cursor/mcp.json (user) or <project>/.cursor/mcp.json (project), then restart Cursor. Replace the placeholder. If the plugin is also installed, delete this block so tools are not duplicated.

{
  "mcpServers": {
    "smartgate": {
      "type": "streamable-http",
      "url": "https://smartgate.network/api/mcp",
      "headers": {
        "Authorization": "Bearer sk_live_REPLACE_WITH_YOUR_KEY",
        "X-SmartGate-Agent-Platform": "cursor"
      }
    }
  }
}

Claude Code / claude.ai fallback (only if the plugin is not installed). Same endpoint, Claude's http type, and ${user_config.SMARTGATE_API_KEY} in the plugin copy of .mcp.json:

{
  "mcpServers": {
    "smartgate": {
      "type": "http",
      "url": "https://smartgate.network/api/mcp",
      "headers": {
        "Authorization": "Bearer sk_live_REPLACE_WITH_YOUR_KEY",
        "X-SmartGate-Agent-Platform": "claude"
      }
    }
  }
}

Hosted endpoint: POST https://smartgate.network/api/mcp (Streamable HTTP). Mint a key at Dashboard → API Keys. If you also add the standalone SmartGate MCP connector from the directory, use the same URL so tools are not duplicated.

Data handling

This plugin does not run fetch, search, compression, or memory inside Cursor or Claude. Those steps run on the hosted gateway at https://smartgate.network/api/mcp. The host model (Cursor or Claude) stays on the client.

• In transit: HTTPS + Authorization: Bearer. The plugin ships no secrets. You set SMARTGATE_API_KEY in the host's plugin configure dialog (Cursor variables, or Claude userConfig).
• At rest: we store a hash of API keys, not the raw secret. Teams are isolated by the key's tenant. Do not pass a foreign team_id.
• What is logged: tool name, timestamp, token counts, and for fetch the requested URL. Retention: Free 7 days · Pro 30 · Teams 90 · Enterprise 180. See Security and Logs.
• Compression / dedup: smart_context_gate (LLMLingua) and smart_dedup (SemHash) run on SmartGate servers, not locally. They shrink or drop overlapping text; they are not a PII redaction product. Do not put secrets or credentials in tool arguments or memory.
• What we do not do: we are not an LLM proxy and do not train a public chatbot on your prompts as a consumer product. Billing card data is handled by Paddle, not stored by us.

Privacy Policy · Terms · SECURITY.md · support@smartgate.network

Troubleshooting

Symptom	Check
401 Unauthorized	SMARTGATE_API_KEY is set in the host's plugin configure dialog; key is sk_live_…
Tools empty	Restart Cursor, or in Claude Code run /mcp and reconnect plugin:smartgate:smartgate
405 on GET	Endpoint is POST /api/mcp, not GET SSE
Duplicate tools	Remove a hand-written smartgate block from ~/.cursor/mcp.json or ~/.claude.json

Workflow source

workflows/ is the scenario source (YAML + Markdown). skills/ is the committed plugin pack, generated by:

pip install jsonschema pyyaml
python scripts/install-skills.py --client cursor --target skills --force
python tests/validate.py

Workflow	Description
research-agent	search → fetch → dedup → compress
deep-reading	fetch → compress
remember-and-recall	team memory
usage-report	budget check / count

Manual skill install (no Marketplace): see clients/README.md.

Maintainers

SmartGate · support@smartgate.network

License

MIT