Skip to main content
Glama
persistenceone-bridgekitty

persistenceone-bridgekitty

Official

BridgeKitty 🐱

Cross-chain bridge aggregator MCP server for AI agents. One server, 5 bridge backends, best routes across EVM, Solana, and Cosmos chains.

BridgeKitty gives AI agents (Claude, Cursor, GPT, or any MCP-compatible AI) the ability to find and execute cross-chain bridge transfers — with automatic route optimization, fee comparison, balance checks, and safety warnings.

Latest npm release: @persistenceone/bridgekitty@0.3.9

What's New in v0.3.9

  • XPRT tools extracted — staking, rewards, and farming tools moved to the standalone xprt-farming-toolkit package

  • Persistence Interop backend removed — BridgeKitty is now a focused bridge aggregator across 5 backends (deBridge, Relay, LI.FI, Across, Squid)

  • Slimmer surface area — fewer tools, clearer scope for agents

  • sign_and_send parameter — agents can now sign and broadcast transactions directly using locally-stored wallet keys

  • Full EVM signing support — works with all EVM backends (Across, Relay, LI.FI, Squid, deBridge) + Persistence Interop (EIP-712)

  • Simulation fix — ERC20 bridges now work on fresh wallets (previously blocked by premature simulation)

  • Solana signing — coming in next release

  • Solana support — bidirectional bridging EVM ↔ Solana (native SOL delivery, not wrapped)

  • Cosmos support — EVM → Persistence/Cosmos Hub via Squid (Axelar)

  • Protocol fee transparency — deBridge fixFee, operating expenses, and total cost visible in every quote

  • Balance warnings — warns when wallet can't cover bridge amount + protocol fees + gas

  • XPRT staking — stake/unstake/claim rewards directly from the MCP server

  • Farming multiplier — tracks your staking tier (1x → 3x → 5x) from the rewards API

  • Quote auto-refresh — expired quotes automatically re-fetched on execute (60s expiry)

  • ERC-20 approvals — always generated for token bridges (Relay + deBridge)

  • Bridge status tracking — on-chain fallback when provider API hasn't indexed yet

Related MCP server: LI.FI MCP Server

Supported Bridges

Backend

Type

Chains

Strength

deBridge (DLN)

Direct

EVM + Solana

Fast intent-based fills, Solana support

Relay

Direct

EVM + Solana

No protocol fee, gas-optimized

LI.FI

Aggregator

EVM

Widest coverage (30+ bridges, any-to-any swap)

Across

Direct

EVM

Fastest fills (~6s), same-token bridging

Squid (Axelar)

Aggregator

EVM + Cosmos

Only option for EVM → Cosmos routes

Bridge Directions

Direction

Backends

Status

EVM → EVM

All 5

āœ… Production

EVM → Solana

deBridge, Relay

āœ… Production

Solana → EVM

deBridge

āœ… Production

EVM → Cosmos

Squid

āœ… Production

Quick Start

npx (zero install)

npx @persistenceone/bridgekitty

Claude Code

Add to your MCP config (~/.claude/claude_code_config.json):

{
  "mcpServers": {
    "bridgekitty": {
      "command": "npx",
      "args": ["@persistenceone/bridgekitty"]
    }
  }
}

Cursor IDE

Add to Cursor's MCP settings (Settings > MCP Servers):

{
  "bridgekitty": {
    "command": "npx",
    "args": ["@persistenceone/bridgekitty"]
  }
}

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "bridgekitty": {
      "command": "npx",
      "args": ["@persistenceone/bridgekitty"]
    }
  }
}

Wallet Setup

BridgeKitty can manage wallets for autonomous bridging. Run wallet_setup to create wallets for EVM, Cosmos, and Solana — or provide your own addresses in quotes.

Wallet config is stored in ~/.bridgekitty/.env (or the directory you run from). Keys never leave the local machine.

Variable

Description

PRIVATE_KEY

EVM private key (hex)

MNEMONIC

BIP-39 mnemonic (derives EVM, Cosmos, Solana keys)

SOLANA_PRIVATE_KEY

Solana private key (base58)

Transaction Signing

By default, bridge_execute returns unsigned transactions for the agent or user to sign externally.

Set sign_and_send: true to enable autonomous signing — BridgeKitty will use the wallet keys stored in ~/.bridgekitty/.env to handle the full flow:

  1. Approval — sends ERC-20 approval transaction (if needed)

  2. Re-build — re-fetches the bridge transaction with updated nonce (if approval was sent)

  3. Simulate — runs eth_estimateGas pre-flight check

  4. Sign — signs the transaction with the local private key

  5. Broadcast — submits to the chain and returns the tx hash + explorer link

Optional API Keys

Variable

Description

LIFI_API_KEY

LI.FI API key (higher rate limits)

DEBRIDGE_API_KEY

deBridge API key

SQUID_INTEGRATOR_ID

Squid integrator ID

MCP Tools

Core Bridge Tools

Tool

Description

bridge_get_quote

Get competitive quotes from all backends. Shows fees, time estimates, balance warnings.

bridge_execute

Build transaction(s) from a quote. Handles approvals, auto-refreshes expired quotes. Set sign_and_send: true to auto-sign and broadcast.

bridge_status

Track bridge progress. On-chain fallback when API hasn't indexed yet.

bridge_chains

List supported chains with provider coverage.

bridge_tokens

Search tokens on a chain.

Multi-hop & Discovery

Tool

Description

bridge_quote_multi

Multi-hop route resolution when no direct route exists.

bridgekitty_help

Agent onboarding guide with examples and tool usage.

xprt_onboard

Guided onboarding flow for first-time users.

Wallet Tools

Tool

Description

wallet_setup

Create wallets for EVM, Cosmos, Solana from a single mnemonic.

wallet_import

Import an existing wallet from a mnemonic or private key.

wallet_status

Show configured wallet addresses and key source.

wallet_balance

Check balances across all chains with USD prices (CoinGecko).

XPRT staking & farming has moved to the standalone xprt-farming-toolkit package.

Example: Bridge USDC from Base to Arbitrum

Default (unsigned transactions)

Agent: "Bridge 100 USDC from Base to Arbitrum"

→ bridge_get_quote: Gets quotes from deBridge, Relay, LI.FI, Across
→ Shows: best rate, fees, estimated time, balance check
→ bridge_execute: Builds approval tx + bridge tx
→ Agent signs and sends both transactions
→ bridge_status: Tracks until destination confirmed

With sign_and_send (autonomous signing)

Agent: "Bridge 100 USDC from Base to Arbitrum"

→ bridge_get_quote: Gets quotes from all backends
→ bridge_execute with sign_and_send: true
  → Auto-signs approval tx + bridge tx using local wallet keys
  → Returns tx hash + explorer link
→ bridge_status: Tracks until destination confirmed

Architecture

Agent → MCP Tools → Routing Engine → [deBridge, Relay, LI.FI, Across, Squid]
                         ↓
                   Quote Cache (60s) + Circuit Breaker
                         ↓
                   Best Quote → buildTransaction
                         ↓
              ā”Œā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”“ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”
              ↓                     ↓
        Unsigned TX          Signed + Broadcast
         (default)            (sign_and_send)
  • Routing Engine: Parallel quotes from all backends, ranked by output amount

  • Circuit Breaker: Auto-skips failing backends, gradual recovery

  • Token Registry: 45+ verified tokens with canonical addresses per chain

  • Gas Estimator: Chain-aware gas cost estimation with multi-RPC failover

  • Balance Checker: Validates token + native balance for fees before execution

  • Fee Transparency: Protocol fees (deBridge fixFee, operating expenses) surfaced in every quote

Security

  • Exact-amount approvals only (never unlimited)

  • Transaction simulation before execution

  • Verified token registry prevents address spoofing

  • No private keys in MCP protocol — agents sign transactions externally

  • sign_and_send uses locally-stored keys only (never transmitted over the network)

  • Circuit breaker prevents cascading failures

  • Error messages sanitized (no key/path leakage)

  • .env file permission checks + overwrite protection

Known Limitations

  • Solana → EVM returns a serialized transaction for external signing (no auto-execute)

  • Relay status tracking may show "unknown" for completed cross-chain bridges

  • Solana SPL tokens not yet shown in wallet_balance (only native SOL)

  • Cosmos → EVM bridging not yet supported (only EVM → Cosmos)

License

MIT

Available Tools

12 tools
bridge_chainsA

List supported chains for cross-chain bridging. Shows which providers support each chain. Chains are deduplicated and grouped by ecosystem: EVM, Cosmos, and Solana. Use 'search' parameter to filter by chain name. Use this to discover available routes before calling bridge_get_quote.

Inputs: search.

bridge_executeA

Get the unsigned transaction data to execute a cross-chain bridge transfer. Supports all providers: LI.FI, Squid Router, deBridge, Across, Relay, Persistence Interop. By default returns unsigned transaction(s) for the agent/user to sign and send. Set sign_and_send=true to sign and broadcast using the locally-stored wallet key (requires wallet_setup). Preconditions: Call bridge_get_quote first and pass the quoteId. Ensure sufficient gas on source chain. If an approval is needed (unsigned mode), send the approvalTransaction first, then the main transaction. After execution, use bridge_status with the returned trackingId to monitor progress.

Inputs: quoteId (required), slippage, sign_and_send.

bridge_get_quoteA

Get the best cross-chain bridge quote across multiple providers (LI.FI, Squid Router, deBridge, Across, Relay, Persistence Interop). Supports EVM chains, Cosmos chains (Persistence, Cosmos Hub), and Solana. Accepts token symbols (e.g. 'USDC', 'ETH', 'WBTC', 'XPRT', 'ATOM') or contract addresses (0x...). Symbols are resolved to verified canonical addresses only — no unverified tokens. Returns ranked options by output amount, speed, and fees. Includes failedProviders array showing which providers didn't return quotes and why. Preconditions: None for quoting. Use bridge_execute to act on a quote. Error codes: 'Token resolution failed' (unknown symbol), 'Rate limited' (too many requests), 'Validation error' (invalid params).

Inputs: amount (required), toChain (required), toToken (required), fromChain (required), +5 more.

bridgekitty_helpA

Get help and guidance on using BridgeKitty. Topics: overview (default), bridging, farming, wallet, troubleshooting. Returns structured guides with recommended tool sequences and common pitfalls.

Inputs: topic.

bridge_quote_multiA

Get quotes for multi-hop routes across supported EVM chains. Resolves optimal path internally -- e.g., ETH on Base to USDC on Arbitrum may route through WBTC. Returns the full route as ordered hops with per-hop detail. Note: For Cosmos destinations (Persistence, Cosmos Hub), use xprt_farm_boost or bridge_get_quote with Squid Router.

Inputs: amount (required), toChain (required), toToken (required), fromChain (required), +3 more.

bridge_statusA

Check the status of a cross-chain bridge transfer. Supports all providers: LI.FI, Squid Router, deBridge, Across, Relay, Persistence Interop. Provide the tracking ID from bridge_execute, or a transaction hash with provider name. Returns: status (pending/in_progress/completed/failed), source/destination tx hashes, elapsed time, and estimated remaining time.

Inputs: txHash, toChain, provider, fromChain, +1 more.

bridge_tokensA

List popular tokens available for bridging on a given chain. Returns verified token symbols, contract addresses, and decimals. Supports EVM chains and Cosmos chains (Persistence, Cosmos Hub). Use token symbols or addresses from this list in bridge_get_quote.

Inputs: chain (required), search.

wallet_balanceA

Check wallet balances across EVM, Cosmos, and Solana chains. Returns native token balances AND key ERC-20 token balances (USDC, USDT, WETH, WBTC, cbBTC, BTCB) by default. Uses multiple RPCs with automatic failover. Returns per-token balance, USD value (via CoinGecko), and total portfolio value. Call this before any bridging or farming operation to verify sufficient funds and gas.

Inputs: chains, tokens, includeUsd, includeTokens.

wallet_importA

Import existing keys. Alternative: edit ~/.bridgekitty/.env directly (MNEMONIC=, PRIVATE_KEY=0x). Mnemonic gives EVM + Persistence + Solana; privateKey alone gives EVM only. Use wallet_status to check current state.

Inputs: mnemonic, overwrite, privateKey.

wallet_setupA

Create wallets for all supported chains (EVM, Cosmos, Solana). Keys saved to ~/.bridgekitty/.env. Use wallet_status first to check if already configured.

Inputs: no named parameters.

wallet_statusA

Check if a wallet is configured. Returns wallet address, key status, and config file location. Call this FIRST before wallet_setup or wallet_import.

Inputs: no named parameters.

xprt_onboardA

Personalized onboarding for XPRT farming. Detects current wallet state and returns an ordered action plan to go from your current position to actively farming XPRT rewards.

Inputs: no named parameters.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.3/5.0

    Scored across 12 tools

    Disambiguation5/5

    Each tool targets a distinct function: quoting, executing, status checking, chain/token discovery, and wallet operations. The two quote tools (single-hop vs multi-hop) are clearly differentiated by descriptions, eliminating ambiguity.

    Naming Consistency4/5

    All tools use snake_case and follow a domain_verb pattern (bridge_get_quote, wallet_balance). Minor deviations like bridge_quote_multi and xprt_onboard are still readable and predictable, with no mixed conventions.

    Tool Count5/5

    12 tools is well within the ideal scope for a cross-chain bridging and wallet management server. Each tool contributes to the core workflows of quoting, executing, tracking, and wallet setup.

    Completeness4/5

    The bridging lifecycle is covered (quote, execute, status, token/chain discovery, multi-hop), and wallet management is complete (setup, import, balance, status). Onboarding and help tools fill gaps, though farming-specific execution tools are absent.

    Maintenance

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      An MCP server that delivers real-time cross-chain bridge rates and optimal transfer routes to onchain AI agents.
      5
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables AI assistants to interact with LI.FI's cross-chain infrastructure, providing access to blockchain networks, token data, bridges, and transaction services through a standardized protocol.
      -
    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables cross-chain cryptocurrency swap quotes and operations using the deBridge DLN protocol. Provides read-only access to swap estimates, supported chains, token information, and order status tracking across multiple blockchain networks.
      1
      -
    • A
      license
      A
      quality
      C
      maintenance
      Provides cross-chain bridge and swap tools for AI agents using the Relay Protocol to interact with multiple blockchain networks. It enables agents to query supported chains, obtain transaction quotes, and generate unsigned transaction data for token transfers and swaps.
      10
      237 npm
      5
      MIT