Connect an agent

Connect once to give your agent access to your enabled Locus tools. The quickstart lets your agent guide setup. For manual setup, add this MCP server:

MCP server URL

https://api.paywithlocus.com/api/credits/mcp

Use your client’s browser sign-in flow and leave authorization headers empty. The client manages authentication for you. Choose either the plugin or manual setup below. You only need one connection. See MCP for the tool reference and compact mode.

Install the Locus plugin

The Locus plugin adds the MCP connection and three skills:

Locus helps your agent choose Tools and Recipes, check prices, and use results.
Locus setup guides installation, sign-in, and account setup.
Locus Workflows helps your agent build, test, save, and run repeatable processes.

Sign in through your client when prompted. You can create an account during sign-in; the client stores and refreshes the connection’s tokens.

Claude Code
Codex CLI
Hermes
Grok
OpenClaw

Install in Claude Code

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

Run /mcp, select locus, and choose Authenticate.

Install in Codex CLI

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

Start a new CLI session after installation.

Install in Hermes

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

Complete browser sign-in, then start a new Hermes session.

Review the plugin repository, then install:

Install in Grok

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

Grok opens browser sign-in when you first use the connection.

Install in OpenClaw

openclaw plugins install locus --marketplace locus-technologies/locus-pro-plugin
openclaw gateway restart
openclaw mcp login locus

The bundle includes the MCP server. You do not need to add it separately.

Already connected manually? Remove the duplicate manual entry when switching to the plugin. One connection is enough.

Configure the MCP server directly

Use this option if you haven’t installed the plugin. Cursor and Cline can connect directly this way.

Codex CLI
Claude Code
Cursor
Cline
Other clients

Connect Codex CLI

codex mcp add locus-pro --url https://api.paywithlocus.com/api/credits/mcp
codex mcp login locus-pro --scopes mcp:read,mcp:execute,offline_access

Connect Claude Code

claude mcp add --transport http locus-pro \
  https://api.paywithlocus.com/api/credits/mcp

Run /mcp, select locus-pro, and choose Authenticate.

Add this to ~/.cursor/mcp.json, then complete browser sign-in:

~/.cursor/mcp.json

{
  "mcpServers": {
    "locus-pro": {
      "url": "https://api.paywithlocus.com/api/credits/mcp"
    }
  }
}

Connect Cline

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

Choose Remote (HTTP) and OAuth, leave the client ID blank, and complete browser sign-in.

Other plugin and skill clients

For a client that supports the Agent Plugins standard:

Agent Plugins-compatible clients

npx plugins add locus-technologies/locus-pro-plugin

To install the three skills in an Agent Skills-compatible client:

Install skills only

npx skills add locus-technologies/locus-pro-plugin

Select locus, locus-setup, and locus-workflows when prompted. A skills-only install still needs the MCP connection above. If your client cannot install skills, your agent can retrieve the same guides through MCP using get_locus_guide.

Keep the plugin up to date

Use your client’s plugin manager to update Locus, then start a fresh session. For OpenClaw, restart the gateway after a plugin change. Keep an existing working connection when updating. See the plugin releases for changes. Public marketplace listings may update separately from the GitHub version.

Check the connection

Ask your agent to find a tool for a task. If it needs access, approve the request or enable the tool under Tools. Open Connections to review active clients. One client is included; connection plans add capacity for more agent apps.

Troubleshoot

Problem	Next step
No Locus tools appear	Complete browser sign-in, then refresh the client
A tool is missing	Enable it under Tools and refresh the tool list
Authentication error	Authenticate again through the client
Insufficient credits	Add funds under Credits
Connection limit reached	Revoke an unused client or change your plan

For an agent that owns its own account, see agent-native onboarding.

Getting started

Use Locus Pro

Explore tools

Agent access

Install the Locus plugin

Configure the MCP server directly

Other plugin and skill clients

Keep the plugin up to date

Check the connection

Troubleshoot

​Install the Locus plugin

​Configure the MCP server directly

​Other plugin and skill clients

​Keep the plugin up to date

​Check the connection

​Troubleshoot

Install the Locus plugin

Configure the MCP server directly

Other plugin and skill clients

Keep the plugin up to date

Check the connection

Troubleshoot