brighty

brighty-agent-toolkit

Banking infrastructure for AI agents. Use Brighty from Claude, Codex, Cursor, OpenClaw, or any MCP-compatible client to open accounts, issue cards, send SEPA/SWIFT payments, run mass payouts, and pay invoices — all through natural language.

This repository ships three things in one place:

• MCP server — exposes the Brighty API as 24 tools over stdio. Works with any MCP client.
• AgentSkills — four AgentSkills-spec skills (banking, payouts, invoice payment, card management) that teach an agent when and how to call the tools. Work in any AgentSkills-compatible client (Claude, Codex, Cursor, OpenClaw, ...).
• Anthropic plugin manifest — bundles the above for one-command install via /plugin marketplace add in Claude Code or Claude Desktop. The plugin wrapper is Anthropic-specific; the underlying MCP server and skills are not.

Specialized agents and slash commands for common workflows are planned for 0.1 — see the roadmap note below.

Quick start

Status: Published to npm as @brighty-app/mcp-server and installable as a Claude Code plugin from this GitHub repo. ClawHub publishing of individual skills is on the roadmap, not done.

Get a Brighty API key from the Brighty Business Portal — Owner role only. Set it as the BRIGHTY_API_KEY environment variable, or store it once in the OS keychain via the bundled login CLI (see Authentication).

Claude Code / Claude Desktop (recommended)

/plugin marketplace add razz-team/brighty-agent-toolkit
/plugin install brighty@brighty-agent-toolkit

This registers the stdio MCP server (via npx -y -p @brighty-app/mcp-server@<pinned-version> brighty-mcp — the -p form is required because the package ships two bins, brighty-mcp and brighty-mcp-login, neither of which matches the unscoped package name) and installs all four skills. The bundled .mcp.json pins the server version to match the plugin manifest version, so the npm dist-tag does not float independently of the plugin release. The two are kept in sync automatically by scripts/sync-versions.mjs when changesets bumps the package — see docs/CHANGESETS.md.

BRIGHTY_API_KEY and (optionally) BRIGHTY_API_URL are forwarded from the environment of whatever shell you launch Claude Code from — set them before launch.

Local checkout (development / unpublished features)

git clone https://github.com/razz-team/brighty-agent-toolkit
cd brighty-agent-toolkit
corepack enable
yarn install
yarn workspace @brighty-app/mcp-server build

Then point your MCP client command at node /absolute/path/to/brighty-agent-toolkit/packages/mcp-server/dist/index.js.

Skills only — any AgentSkills-compatible client

cp -r skills/* ~/.claude/skills/
# or ~/.codex/skills/, ~/.agents/skills/, etc.

The skills assume the Brighty MCP server is reachable over stdio — set it up in your client first, then drop the skill files in.

Ask your agent to install it

If you'd rather have your agent run the install for you, paste this prompt:

Install Brighty into this client. Read
https://github.com/razz-team/brighty-agent-toolkit/blob/master/AGENTS.md
and follow the path matching the client we're in.

AGENTS.md walks the agent through Claude Code, generic MCP clients, skill-only setups, and credential persistence.

What's inside

Skills

Skill	Use case
brighty-banking	Balances, account info, transfers between own accounts, basic queries
brighty-payouts	Mass payouts, payroll runs, CSV/Excel ingestion
brighty-invoice-pay	Pay an invoice from a PDF or image
brighty-cards	Issue, freeze, set limits on business cards

Each skill is self-contained and installs independently. They all assume the Brighty MCP server is reachable over stdio.

MCP server