mcpField
B
Bankr Agent - Safety & Access Control

Bankr Agent - Safety & Access Control

github.com/bankrbotSecurity88322 installsUpdated 31w ago
Repository

About Bankr Agent - Safety & Access Control

A safety skill for using the Bankr API and CLI, covering key permissions, IP restrictions, wallet separation, and transaction precautions. It is intended for developers configuring access for agents and protecting funds and credentials.

Key features

  1. 01Explain API key capability flags
  2. 02Restrict access with read-only keys
  3. 03Limit key use by IP address
  4. 04Recommend separate agent wallets
  5. 05Cover key storage and rotation
  6. 06List transaction safety checks

Use cases

  1. 01Restrict an agent to read-only queries
  2. 02Limit API key use to approved IPs
  3. 03Separate agent funds from a personal wallet
  4. 04Prepare credentials and safeguards before deployment

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/bankrbot/claude-plugins --skill bankr-agent---safety-&-access-control

After installing, type/bankr-agent---safety-&-access-controlin Claude Code to confirm it loaded.

Details

From the project README

Safety & Access Control

Comprehensive safety guidance for using the Bankr API and CLI.

API Key Types

Bankr uses a single key format (bk_...) with capability flags:

FlagControlsDefault
agentApiEnabled/agent/* endpointsfalse
llmGatewayEnabledLLM Gateway at llm.bankr.botfalse
readOnlyRestricts agent to read-only toolsfalse

Manage flags at bankr.bot/api.

Read-Only API Keys

When readOnly: true, all write tools are filtered from the agent session:

Allowed: Balances, prices, analytics, portfolio, research Blocked: Swaps, transfers, NFT purchases, staking, orders, token launches, leverage, Polymarket bets, claims

The /agent/sign and /agent/submit endpoints return 403 for read-only keys.

IP Whitelisting

Set allowedIps on your API key to restrict usage to specific IPs. Requests from non-whitelisted IPs are rejected with 403.

  • Empty array = all IPs allowed (default)
  • Non-empty array = only listed IPs can use the key

Dedicated Agent Wallet

When building autonomous agents, create a separate Bankr account rather than using your personal wallet:

  • Limited exposure — compromised key only exposes agent wallet funds
  • Clear accounting — agent transactions isolated from personal activity
  • Independent controls — apply stricter access controls without affecting personal use
  • Easy revocation — disable agent account without disrupting primary wallet
Recommended Funding
ChainGas BufferTrading Capital
Base0.01-0.05 ETHAs needed
Polygon5-10 MATICAs needed
Ethereum0.05-0.1 ETHAs needed
Solana0.1-0.5 SOLAs needed

Rate Limits

TierDaily Limit
Standard100 messages/day
Bankr Club1,000 messages/day
CustomSet per API key

Reset window is 24 hours from first message (rolling), not midnight.

Key Management

  • Store keys in environment variables (BANKR_API_KEY, BANKR_LLM_KEY), never in source code
  • Add ~/.bankr/ and .env to .gitignore
  • Rotate keys periodically at bankr.bot/api
  • Revoke immediately if compromised
  • Use separate keys for Agent API vs LLM Gateway if needed

Transaction Safety

  • Test first — small amounts on Base/Polygon before scaling
  • Verify recipients — double-check addresses before transfers
  • Gas buffer — keep enough native tokens for gas
  • Immediate execution — /agent/submit executes with no confirmation prompt
  • Understand calldata — verify trusted source for arbitrary transactions

Pre-Deployment Checklist

  • Use a dedicated agent wallet, not your personal account
  • Fund with limited amounts appropriate to purpose
  • Set read-only if agent only queries data
  • Configure IP whitelisting for server-side agents
  • Store keys in environment variables
  • Test with small amounts first
  • Implement error handling for rate limits (429) and access control (403)

Comments

Markdown supported