Plugin MCP Server
by circularrouteai.circulara/pluginv0.1.2
Circulara Observe MCP plugin - meters your AI agents' token spend and carbon, free tier.
context tax
queued
security
queued
cold start
queued
freshness
Slowing3mo ago
Install Plugin MCP server
Install in Claude Code
claude mcp add plugin -e CIRCULARA_BACKEND_URL='<circulara-backend-url>' -e CIRCULARA_TENANT_ID='<circulara-tenant-id>' -e CIRCULARA_TOKEN='<circulara-token>' -e CIRCULARA_SEAT_ID='<circulara-seat-id>' -e CIRCULARA_USER_ID='<circulara-user-id>' -- npx -y @circulara/pluginInstall in Cursor
{
"mcpServers": {
"plugin": {
"command": "npx",
"args": [
"-y",
"@circulara/plugin"
],
"env": {
"CIRCULARA_BACKEND_URL": "<circulara-backend-url>",
"CIRCULARA_TENANT_ID": "<circulara-tenant-id>",
"CIRCULARA_TOKEN": "<circulara-token>",
"CIRCULARA_SEAT_ID": "<circulara-seat-id>",
"CIRCULARA_USER_ID": "<circulara-user-id>"
}
}
}
}Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).
Install in Claude Desktop
{
"mcpServers": {
"plugin": {
"command": "npx",
"args": [
"-y",
"@circulara/plugin"
],
"env": {
"CIRCULARA_BACKEND_URL": "<circulara-backend-url>",
"CIRCULARA_TENANT_ID": "<circulara-tenant-id>",
"CIRCULARA_TOKEN": "<circulara-token>",
"CIRCULARA_SEAT_ID": "<circulara-seat-id>",
"CIRCULARA_USER_ID": "<circulara-user-id>"
}
}
}
}Settings → Developer → Edit Config (claude_desktop_config.json), then restart.
Install in VS Code
{
"servers": {
"plugin": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@circulara/plugin"
],
"env": {
"CIRCULARA_BACKEND_URL": "<circulara-backend-url>",
"CIRCULARA_TENANT_ID": "<circulara-tenant-id>",
"CIRCULARA_TOKEN": "<circulara-token>",
"CIRCULARA_SEAT_ID": "<circulara-seat-id>",
"CIRCULARA_USER_ID": "<circulara-user-id>"
}
}
}
}Add to .vscode/mcp.json in your workspace.
Install in Windsurf
{
"mcpServers": {
"plugin": {
"command": "npx",
"args": [
"-y",
"@circulara/plugin"
],
"env": {
"CIRCULARA_BACKEND_URL": "<circulara-backend-url>",
"CIRCULARA_TENANT_ID": "<circulara-tenant-id>",
"CIRCULARA_TOKEN": "<circulara-token>",
"CIRCULARA_SEAT_ID": "<circulara-seat-id>",
"CIRCULARA_USER_ID": "<circulara-user-id>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json.
Configuration
| Variable | Required | Secret | Description |
|---|---|---|---|
| CIRCULARA_BACKEND_URL | yes | — | Your Circulara Observe backend URL - copy from the Connect page after signing in at https://plugin.circulara.ai |
| CIRCULARA_TENANT_ID | yes | — | Your workspace ID - from the Connect page |
| CIRCULARA_TOKEN | yes | yes | Your signed workspace token - from the Connect page (keep secret) |
| CIRCULARA_SEAT_ID | yes | — | Your seat ID - from the Connect page |
| CIRCULARA_USER_ID | yes | — | Your email / identity - from the Connect page |
Freshness
Slowing — last maintenance signal 3mo ago. The newest of the signals below sets the band.
Last commit (default branch)
no data · GitHub
Latest release
no data · GitHub
Package published
no data · npm/PyPI
Registry entry updated
2026-07-09 · 3mo ago · official registry · v0.1.2
FAQ
›How do I install the Plugin MCP server in Claude Code?
Run: claude mcp add plugin -e CIRCULARA_BACKEND_URL='<circulara-backend-url>' -e CIRCULARA_TENANT_ID='<circulara-tenant-id>' -e CIRCULARA_TOKEN='<circulara-token>' -e CIRCULARA_SEAT_ID='<circulara-seat-id>' -e CIRCULARA_USER_ID='<circulara-user-id>' -- npx -y @circulara/plugin. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.
›Does Plugin require an API key?
Yes. It expects CIRCULARA_BACKEND_URL, CIRCULARA_TENANT_ID, CIRCULARA_TOKEN, CIRCULARA_SEAT_ID, CIRCULARA_USER_ID, of which 1 is a secret.
›Can I use Plugin as a remote (hosted) MCP server?
No hosted endpoint is published; it runs locally over stdio.
›Is Plugin in the official MCP registry?
Yes, as ai.circulara/plugin.