{"_id":"@clevername/clevername-mcp","_rev":"3-f8483981d3a3996cb2d1c5ac0600651e","name":"@clevername/clevername-mcp","dist-tags":{"latest":"1.1.2"},"versions":{"1.1.0":{"name":"@clevername/clevername-mcp","version":"1.1.0","keywords":["mcp","model-context-protocol","clevername","ai-gateway","claude","llm","cleveragent","automation"],"_id":"@clevername/clevername-mcp@1.1.0","maintainers":[{"name":"alexfloyd13","email":"Alex@sportsball.news"}],"homepage":"https://clevername.net/dashboard/settings/developer","bugs":{"url":"https://github.com/AlexFloyd13/clevername/issues"},"bin":{"clevername-mcp":"dist/index.js"},"dist":{"shasum":"60832db1bee4b2aa457805f9b6a1bbaa9c71237b","tarball":"https://registry.npmjs.org/@clevername/clevername-mcp/-/clevername-mcp-1.1.0.tgz","fileCount":92,"integrity":"sha512-rVBXt/WN4DMDhFo+96nhc8kJx9CrOYgulmpTMZgtAcUEKGUZC2TUw5tKpw12XB4sSF8uDQxZSLlLMYwmJb5UKA==","signatures":[{"sig":"MEQCIHeAPS8Ran4TXb8Gti+ASaGtXeDrvMqrWqxGwcTbKcc5AiBhRPVvZNhMAyd4Phwj0sIhGjjt5vjjAAvhzrN6I+8cWQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":455807},"main":"dist/index.js","types":"./dist/index.d.ts","engines":{"node":">=18"},"gitHead":"170af8fa57ff1fccd3fdf643eaafa3eee9a075db","scripts":{"dev":"ts-node src/index.ts","build":"tsc","start":"node dist/index.js","prepublishOnly":"npm run build"},"_npmUser":{"name":"alexfloyd13","email":"Alex@sportsball.news"},"repository":{"url":"git+https://github.com/AlexFloyd13/clevername.git","type":"git"},"_npmVersion":"11.7.0","description":"Local Clevername MCP bridge for stdio clients. Modern clients should connect directly to the Clevername MCP gateway with OAuth; this package remains available for token-based fallback setups.","directories":{},"_nodeVersion":"25.4.0","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"ts-node":"^10.9.0","typescript":"^5.3.0","@types/node":"^20.0.0"},"_npmOperationalInternal":{"tmp":"tmp/clevername-mcp_1.1.0_1774396286114_0.5865594943686576","host":"s3://npm-registry-packages-npm-production"}},"1.1.1":{"name":"@clevername/clevername-mcp","version":"1.1.1","keywords":["mcp","model-context-protocol","clevername","ai-gateway","claude","llm","cleveragent","automation"],"_id":"@clevername/clevername-mcp@1.1.1","maintainers":[{"name":"alexfloyd13","email":"Alex@sportsball.news"}],"homepage":"https://clevername.net/dashboard/settings/developer","bugs":{"url":"https://github.com/AlexFloyd13/clevername/issues"},"bin":{"clevername-mcp":"dist/index.js"},"dist":{"shasum":"dcd31a264d5fe020be8c043ceea3c0df548dce50","tarball":"https://registry.npmjs.org/@clevername/clevername-mcp/-/clevername-mcp-1.1.1.tgz","fileCount":92,"integrity":"sha512-FChBgRa6nSNo7tUjZyAdO7cRH9Hfku/p/2zJJgoqSDEwclx106mve4F9wHEhAgQMBtW7V6t1kFJxV/Cn9/UM5Q==","signatures":[{"sig":"MEQCIDGwfUGmSiASi6WheJIfkAsQECKvZ0/0GzzkvBQ/hFRhAiArYs6YKJDQKGv+2HIPMkqTg4SlqOuz+J2P1iU3tTXVOg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":456224},"main":"dist/index.js","types":"./dist/index.d.ts","engines":{"node":">=18"},"gitHead":"51c18ac6990774fecf3c8da0eaddd328e4858ec8","scripts":{"dev":"ts-node src/index.ts","build":"tsc","start":"node dist/index.js","prepublishOnly":"npm run build"},"_npmUser":{"name":"alexfloyd13","email":"Alex@sportsball.news"},"repository":{"url":"git+https://github.com/AlexFloyd13/clevername.git","type":"git"},"_npmVersion":"11.7.0","description":"Local Clevername MCP bridge for stdio clients. Modern clients should connect directly to the Clevername MCP gateway with OAuth; this package remains available for token-based fallback setups.","directories":{},"_nodeVersion":"25.4.0","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"ts-node":"^10.9.0","typescript":"^5.3.0","@types/node":"^20.0.0"},"_npmOperationalInternal":{"tmp":"tmp/clevername-mcp_1.1.1_1774396364942_0.20731006592188517","host":"s3://npm-registry-packages-npm-production"}},"1.1.2":{"name":"@clevername/clevername-mcp","mcpName":"io.github.AlexFloyd13/clevername-mcp","version":"1.1.2","description":"Local Clevername MCP bridge for stdio clients. Modern clients should connect directly to the Clevername MCP gateway with OAuth; this package remains available for token-based fallback setups.","repository":{"type":"git","url":"git+https://github.com/AlexFloyd13/clevername.git"},"homepage":"https://clevername.net/dashboard/settings/developer","main":"dist/index.js","bin":{"clevername-mcp":"dist/index.js"},"scripts":{"build":"tsc","prepublishOnly":"npm run build","start":"node dist/index.js","dev":"ts-node src/index.ts"},"keywords":["mcp","model-context-protocol","clevername","ai-gateway","claude","llm","cleveragent","automation"],"engines":{"node":">=18"},"publishConfig":{"access":"public"},"dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"devDependencies":{"typescript":"^5.3.0","@types/node":"^20.0.0","ts-node":"^10.9.0"},"gitHead":"d5cdb79ff66cd34434a7bd4059caad76eb17134a","types":"./dist/index.d.ts","_id":"@clevername/clevername-mcp@1.1.2","bugs":{"url":"https://github.com/AlexFloyd13/clevername/issues"},"_nodeVersion":"25.4.0","_npmVersion":"11.7.0","dist":{"integrity":"sha512-qi7qsQiBz4CTqM3P+ZglPXHxVAMpIji0Qgput7jul1Xmo91/nJuFHs9SSSFV/fT9cYvQyDDk4TyTaGLL4vD4QA==","shasum":"2251e0f44cdb0fb3de52d46b654ede203ae7c2c0","tarball":"https://registry.npmjs.org/@clevername/clevername-mcp/-/clevername-mcp-1.1.2.tgz","fileCount":92,"unpackedSize":510856,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQC6gyWh0nUN1bOFO+iKvkT4opxKtTHybfvpsYEirS+mJgIgYliaYh3pXQ+aN+4Jhq/w4DwM1djSWpIHzt1JtBlZRFQ="}]},"_npmUser":{"name":"alexfloyd13","email":"Alex@sportsball.news"},"directories":{},"maintainers":[{"name":"alexfloyd13","email":"Alex@sportsball.news"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/clevername-mcp_1.1.2_1774799394260_0.45383011102788107"},"_hasShrinkwrap":false}},"time":{"created":"2026-03-24T23:51:25.975Z","modified":"2026-03-29T15:49:54.598Z","1.1.0":"2026-03-24T23:51:26.278Z","1.1.1":"2026-03-24T23:52:45.081Z","1.1.2":"2026-03-29T15:49:54.446Z"},"bugs":{"url":"https://github.com/AlexFloyd13/clevername/issues"},"homepage":"https://clevername.net/dashboard/settings/developer","keywords":["mcp","model-context-protocol","clevername","ai-gateway","claude","llm","cleveragent","automation"],"repository":{"type":"git","url":"git+https://github.com/AlexFloyd13/clevername.git"},"description":"Local Clevername MCP bridge for stdio clients. Modern clients should connect directly to the Clevername MCP gateway with OAuth; this package remains available for token-based fallback setups.","maintainers":[{"name":"alexfloyd13","email":"Alex@sportsball.news"}],"readme":"# clevername-mcp\n\nThe official MCP server for [Clevername](https://clevername.net) — AI agent governance, security, and routing.\n\nNo account needed to get started. Run one command, call one tool, and you're in.\n\n---\n\n## Quickstart (2 steps)\n\n### Step 1 — Add the server to your client\n\n**Claude Code**\n```bash\nclaude mcp add clevername-mcp --transport http https://clevername.net/api/hub/mcp/gateway\n```\n\n**Cursor** — one-click install:\n\n[![Install in Cursor](https://cursor.com/deeplink/mcp-install-dark.svg)](cursor://anysphere.cursor-deeplink/mcp/install?name=clevername-mcp&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBjbGV2ZXJuYW1lL2NsZXZlcm5hbWUtbWNwIl19)\n\nOr add manually to your Cursor MCP config:\n\n**Claude Desktop / Windsurf** — add to your MCP config:\n```json\n{\n  \"mcpServers\": {\n    \"clevername\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@clevername/clevername-mcp\"]\n    }\n  }\n}\n```\n\n### Step 2 — Log in from the chat\n\nAsk your AI assistant:\n\n> \"Call the clevername_login tool\"\n\nYou'll see a code like `WXYZ-5678` appear. Open **https://clevername.net/device**, enter the code, then sign in with **Google** or your **email and password** — done. Your token is saved automatically and every tool unlocks.\n\nThat's it. No dashboard visit required before logging in. No `CLEVERNAME_API_KEY` to copy and paste.\n\n---\n\n## How it works\n\n```\nYour MCP client (Claude Code, Claude Desktop, Cursor…)\n  └── @clevername/clevername-mcp  (local stdio process)\n        ├── clevername_login       ← device flow, no pre-auth needed\n        └── all other tools        ← unlocked after login\n              └── https://clevername.net/api/hub  (hub-core)\n                    └── Your connected MCP servers, AI models, memory, audit\n```\n\nThe `clevername_login` tool uses the [OAuth 2.0 Device Authorization Grant (RFC 8628)](https://www.rfc-editor.org/rfc/rfc8628). It works even before you have an account — signing in at `/device` creates your account automatically via Google OAuth.\n\n---\n\n## Available tools\n\n### Authentication\n| Tool | What it does |\n|------|-------------|\n| `clevername_login` | Authenticate from the CLI — prints a device code, polls until you approve at clevername.net/device. Works with no pre-existing token. |\n\n### Identity & Health\n| Tool | What it does |\n|------|-------------|\n| `get_identity` | Who you're logged in as |\n| `list_models` | Available AI models |\n| `health_check` | Hub status |\n| `refresh_tools` | Force-refresh the tool list |\n\n### AI Chat\n| Tool | What it does |\n|------|-------------|\n| `chat_complete` | Chat with any model via your BYOK keys |\n| `route_plan` | Plan a multi-step agentic task |\n\n### Multi-provider LLM (BYOK)\n| Tool | What it does |\n|------|-------------|\n| `ask_claude` | Call Anthropic with your key |\n| `ask_gpt` | Call OpenAI with your key |\n| `ask_gemini` | Call Google with your key |\n| `ask_llm` | Call any provider by name |\n| `ask_best` | Route to the best model for the task |\n| `ask_consensus` | Ask multiple models and compare answers |\n\n### Memory\n| Tool | What it does |\n|------|-------------|\n| `create_memory` | Save something to persistent memory |\n| `list_memories` | List saved memories |\n| `search_memories` | Search by content |\n| `delete_memory` | Delete a memory |\n\n### MCP Management\n| Tool | What it does |\n|------|-------------|\n| `list_mcp_connections` | See your connected MCP servers |\n| `add_mcp_connection` | Connect a new MCP server |\n| `call_mcp_tool` | Call a tool on any connected server |\n| `list_mcp_tools` | List tools from a server |\n| `ping_mcp_connection` | Check if a server is reachable |\n| `delete_mcp_connection` | Remove a server |\n\n### MCP Activation (plugin registry)\n| Tool | What it does |\n|------|-------------|\n| `list_available_mcps` | Browse the MCP plugin registry |\n| `activate_mcp` | Enable a plugin (GitHub, Slack, Notion…) |\n| `deactivate_mcp` | Disable a plugin |\n| `list_active_mcps` | See what's enabled |\n\n### Guard (AI agent security)\n| Tool | What it does |\n|------|-------------|\n| `guard_onboard_agent` | Register an AI agent with guardrails and get a secure token |\n| `guard_list_agents` | List registered agents |\n| `guard_get_profile` | Get a compiled guardrail profile |\n| `guard_register_agent` | Register without full onboarding |\n| `guard_revoke_token` | Revoke an agent's token |\n\n### Opt-in groups\nEnable additional tool groups with `set_tool_groups`:\n\n| Group | Tools |\n|-------|-------|\n| `telemetry` | Usage summaries, cost reports, audit logs |\n| `projects` | Project CRUD |\n| `config` | Export config, sync from Claude Desktop |\n| `aithroyz` | Cybersecurity environment provisioning |\n| `logging` | Query GCP logs, error monitoring |\n\n---\n\n## Advanced setup\n\n### Use an existing token (CI/CD, headless environments)\n\nIf you're running in a headless environment or already have a token from the dashboard:\n\n```json\n{\n  \"mcpServers\": {\n    \"clevername\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@clevername/clevername-mcp\"],\n      \"env\": {\n        \"CLEVERNAME_API_KEY\": \"cnk_your_token_here\"\n      }\n    }\n  }\n}\n```\n\nTokens are available at [clevername.net/dashboard/settings/developer](https://clevername.net/dashboard/settings/developer).\n\n### Connect directly via HTTP (modern clients)\n\nIf your client supports HTTP MCP with OAuth:\n\n```text\nhttps://clevername.net/api/hub/mcp/gateway\n```\n\nThis skips the local process entirely — the hub handles auth via browser OAuth.\n\n---\n\n## Troubleshooting\n\n**\"clevername_login\" times out** — The device code expires after 5 minutes. Call the tool again to get a fresh code.\n\n**Tools show \"Not authenticated\"** — Call `clevername_login` first. If you already logged in, check that `~/.clevername/config.json` exists.\n\n**`npx` not found** — [Install Node.js](https://nodejs.org) (v18+) and restart your terminal.\n\n**Tools don't appear after login** — Run `refresh_tools` or restart your MCP client.\n\n**\"Unauthorized\" on a specific tool** — Your token may have been revoked. Call `clevername_login` again to get a fresh one.\n\n---\n\n## Development\n\n```bash\ncd integrations/clevername-mcp\nnpm install\nnpm run build\nnode dist/index.js   # stdio mode\n```\n\n## License\n\nMIT\n","readmeFilename":"README.md"}