Locus MCP server

Locus plugin

Pay-per-use APIs for coding agents. This plugin connects the Locus MCP server and teaches your agent how to use it well: cited web research, paid data and API lookups, and thousands of metered provider endpoints billed to one prepaid workspace credit balance.

One repo, one plugin, many agents. The same plugin installs into Claude Code, Codex, Cursor, Grok, OpenClaw, and any client that speaks the Agent Plugins or Agent Skills open standards.

What you get

(streamable HTTP). Sign-in is OAuth with browser consent; no keys are stored in configuration.

• MCP server connection to https://api.paywithlocus.com/api/credits/mcp

routing, cost quotes, idempotent billing, error recovery, and spend safety.

• The locus skill: operating instructions for the agent covering tool

it. Human sign-up through the OAuth page is the default. Agent-owned accounts via AgentID exist for headless runtimes, and only they get agent-driven capability selection and a user-requested Stripe funding handoff; human-owned accounts manage both in the dashboard.

• The locus-setup skill: onboarding when the user asks the agent to do

bounded pilots, immutable versions, and durable run recovery through the same authorized connection.

• The locus-workflows skill: safe hosted Workflow authoring, fixtures,

No account yet? Authenticate the server and create the account on the OAuth sign-in page that opens; that is the whole flow for a person with a browser. Tools are enabled and credits added in the dashboard at platform.paywithlocus.com.

Install

Claude Code

/plugin marketplace add locus-technologies/locus-pro-plugin
/plugin install locus@locus

Then run /mcp, select locus, and authenticate.

Already added the server manually as locus-pro via claude mcp add? Remove

it first (claude mcp remove locus-pro) so you don't carry two connections

to the same server.

Codex

codex plugin marketplace add locus-technologies/locus-pro-plugin
codex plugin add locus@locus
codex mcp login locus

Hermes

hermes plugins install locus
hermes plugins enable locus
hermes mcp login agent-plugin-locus-0b597595__locus

Complete browser OAuth, then start a new Hermes session. The plugin includes the usage, setup, and Workflow skills; no separate skill install is needed.

Cline

cline mcp install locus --transport http \
  https://api.paywithlocus.com/api/credits/mcp

Keep Remote (HTTP), choose OAuth, leave the client ID blank for dynamic registration, and complete sign-in in the browser. No clone, build, API key, or environment variable is required.

Cursor

Add the MCP server directly in ~/.cursor/mcp.json:

{
  "mcpServers": {
    "locus": {
      "url": "https://api.paywithlocus.com/api/credits/mcp",
      "headers": { "X-Source-Name": "cursor-plugin" }
    }
  }
}

Cursor's OAuth flow completes in the browser on first use. Once the Locus listing clears Cursor Marketplace review, you will also be able to install it from Customize → Plugins (search "Locus") or with /add-plugin locus in chat.

Grok

grok plugin install locus-technologies/locus-pro-plugin --trust

Grok requires explicit trust to install plugins (they can run MCP servers and skills); review the repo, then pass --trust. Grok discovers the server's OAuth automatically and opens the browser flow on first use.

OpenClaw

Install the plugin from this repo as a marketplace source; the bundle already maps the MCP server, so no manual server configuration is needed:

Shortened. The full README is on GitHub.