ai.circulara/plugin

Official

by CircularRoute · TypeScript

Circulara Observe MCP plugin - meters your AI agents' token spend and carbon, free tier.

Circulara Observe MCP Plugin

The ai.circulara/plugin is an MCP server plugin that meters AI agents’ token spend and carbon emissions. It is positioned as a free tier service. Configuration is done after signing in at https://plugin.circulara.ai and copying an environment block from the Connect page.

🛠️ Key Features

Tracks token spend for AI agents
Measures carbon emissions
Free tier availability

🚀 Use Cases

Monitor and account for AI token usage
Measure carbon impact associated with agent activity

⚡ Developer Benefits

Centralizes usage and carbon metrics via an MCP plugin
Installable through claude mcp add ... with the provided npm package

⚠️ Limitations

Setup requires signing in and providing an environment block from the Connect page

packages/plugin/README.md1 KBView on GitHub

@circulara/plugin

Circulara Observe MCP plugin - meters your AI agents' token spend and carbon (free tier).

Install (after signing in at https://plugin.circulara.ai and copying your env block from the Connect page):

code

claude mcp add circulara -- npx -y -p @circulara/plugin circulara-mcp

Publishing a new version

Bump version in package.json (keep mcpName = ai.circulara/plugin).
Build + publish to npm: npm run build -w @circulara/plugin then, from packages/plugin, npm publish (public scope, OTP).
Update server.json so its version and each package version match the new npm version (its name must stay ai.circulara/plugin = the package's mcpName).
Publish the MCP-registry entry: mcp-publisher publish using DNS auth for the circulara.ai domain. The DNS signing key is mcp-dns-key.pem - a CREDENTIAL, kept OUT of git (see .gitignore), held by the CTO. Never commit it.

The registry entry auto-propagates to most other MCP directories.

Install

Configuration

Environment variables

CIRCULARA_BACKEND_URLrequired

Your Circulara Observe backend URL - copy from the Connect page after signing in at https://plugin.circulara.ai

CIRCULARA_TENANT_IDrequired

Your workspace ID - from the Connect page

CIRCULARA_TOKENrequiredsecret

Your signed workspace token - from the Connect page (keep secret)

CIRCULARA_SEAT_IDrequired

Your seat ID - from the Connect page

CIRCULARA_USER_IDrequired

Your email / identity - from the Connect page

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "plugin": {
      "command": "npx",
      "args": [
        "-y",
        "@circulara/plugin@0.1.2"
      ],
      "env": {
        "CIRCULARA_BACKEND_URL": "<YOUR_CIRCULARA_BACKEND_URL>",
        "CIRCULARA_TENANT_ID": "<YOUR_CIRCULARA_TENANT_ID>",
        "CIRCULARA_TOKEN": "<YOUR_CIRCULARA_TOKEN>",
        "CIRCULARA_SEAT_ID": "<YOUR_CIRCULARA_SEAT_ID>",
        "CIRCULARA_USER_ID": "<YOUR_CIRCULARA_USER_ID>"
      }
    }
  }
}