How do I install the Locus skill?

Run npx skillmds@latest add modbender/locus in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Locus safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: executes scripts, makes network calls, reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Locus?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Locus free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

modbender (@modbender) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Locus by modbender — Agent Skill

Name: Locus
Rating: 4.5 (4 reviews)
Author: modbender

Locus

Locus payment tools for AI agents. Use when asked to send payments, check wallet balances, list tokens, approve token spending, or process payment-related actions from emails. Also use for demos of Locus (YC F25) payment infrastructure — scanning emails for payment requests and initiating crypto payments via wallet.

modbender Updated Sep 9, 2026 12 repo stars

File contents

Locus Payment Skill

Locus connects AI agents to crypto wallets via MCP. Tools are dynamic — each user gets different tools based on their permission group.

Setup (Agent-Guided)

When the user asks to set up Locus, use payments, or anything payment-related — check if Locus is configured and walk them through setup interactively:

Step 1: Check if mcporter is installed

command -v mcporter || npm i -g mcporter

Step 2: Check if Locus is already configured

mcporter config get locus 2>/dev/null

If configured, skip to Usage. If the user wants to reconfigure, run:

mcporter config remove locus

Step 3: Ask the user for their API key

Tell them:

You'll need a Locus API key to connect your wallet. Get one at https://app.paywithlocus.com — each key is tied to your wallet and permission group. Paste it here when you're ready.

Wait for the user to provide their key. It should start with locus_. If it doesn't, warn them and confirm before proceeding.

Step 4: Configure mcporter

mcporter config add locus \
  --url "https://mcp.paywithlocus.com/mcp" \
  --header "Authorization=Bearer <API_KEY>" \
  --scope home

Step 5: Verify the connection

mcporter list locus

If tools appear, setup is complete — tell the user they're ready. If it fails, ask them to double-check their API key and try again.

Alternative: Script-based setup

Users can also run the setup script directly from the Clawdbot workspace root:

bash skills/locus/scripts/setup.sh

Usage

Always discover available tools first:

mcporter list locus --schema

This returns all tools the user's permission group allows. Tools vary per user — do not assume which tools exist. Use the schema output to understand parameters.

Call any discovered tool:

mcporter call locus.<tool_name> param1=value1 param2=value2

For array/object parameters:

mcporter call locus.<tool_name> --args '{"key": "value"}'

Email → Payment Flow

Scan inbox for payment-related emails (invoices, bills, splits, reimbursements)
Identify actionable items with amounts, recipients, and context
Summarize findings to user
On user approval, execute payments via available tools
Always confirm with user before sending any payment

Safety Rules

Never send payments without explicit user confirmation
Always show: recipient, token, amount, and memo before executing
Check available balance before attempting payments
Double-check recipient addresses — typos mean lost funds
Confirm large payments (>$100) with extra care

---name: locusdescription: Locus payment tools for AI agents. Use when asked to send payments, check wallet balances, list tokens, approve token spending, or process payment-related actions from emails. Also use for demos of Locus (YC F25) payment infrastructure — scanning emails for payment requests and initiating crypto payments via wallet.--- # Locus Payment Skill Locus connects AI agents to crypto wallets via MCP. Tools are **dynamic** — each user gets different tools based on their permission group. ## Setup (Agent-Guided) When the user asks to set up Locus, use payments, or anything payment-related — check if Locus is configured and walk them through setup interactively: ### Step 1: Check if mcporter is installed ```bash command -v mcporter || npm i -g mcporter ``` ### Step 2: Check if Locus is already configured ```bash mcporter config get locus 2>/dev/null ``` If configured, skip to **Usage**. If the user wants to reconfigure, run: ```bash mcporter config remove locus ``` ### Step 3: Ask the user for their API key Tell them: > You'll need a Locus API key to connect your wallet. Get one at **https://app.paywithlocus.com** — each key is tied to your wallet and permission group. Paste it here when you're ready. Wait for the user to provide their key. It should start with `locus_`. If it doesn't, warn them and confirm before proceeding. ### Step 4: Configure mcporter ```bash mcporter config add locus \ --url "https://mcp.paywithlocus.com/mcp" \ --header "Authorization=Bearer <API_KEY>" \ --scope home ``` ### Step 5: Verify the connection ```bash mcporter list locus ``` If tools appear, setup is complete — tell the user they're ready. If it fails, ask them to double-check their API key and try again. ### Alternative: Script-based setup Users can also run the setup script directly from the Clawdbot workspace root: ```bash bash skills/locus/scripts/setup.sh ``` ## Usage **Always discover available tools first:** ```bash mcporter list locus --schema ``` This returns all tools the user's permission group allows. Tools vary per user — do not assume which tools exist. Use the schema output to understand parameters. **Call any discovered tool:** ```bash mcporter call locus.<tool_name> param1=value1 param2=value2 ``` For array/object parameters: ```bash mcporter call locus.<tool_name> --args '{"key": "value"}' ``` ## Email → Payment Flow 1. Scan inbox for payment-related emails (invoices, bills, splits, reimbursements) 2. Identify actionable items with amounts, recipients, and context 3. Summarize findings to user 4. On user approval, execute payments via available tools 5. **Always confirm with user before sending any payment** ## Safety Rules - **Never send payments without explicit user confirmation** - Always show: recipient, token, amount, and memo before executing - Check available balance before attempting payments - Double-check recipient addresses — typos mean lost funds - Confirm large payments (>$100) with extra care

Frequently asked questions