Blend MCP

An AI gateway for the Blend Protocol on Stellar, enabling DeFi actions like lending, borrowing, and pool creation through AI assistants or apps.

View on GitHub →

Blend MCP is the universal AI gateway for the Blend Protocol on Stellar. It exposes all Blend DeFi actions—lending, borrowing, pool creation, risk analysis, and more—as simple, composable tools accessible by any AI assistant, bot, or app.

https://github.com/user-attachments/assets/008f02d5-1037-4b28-b1be-0af312f88de4

🚀 Features

  • Natural Language DeFi: Lend, borrow, repay, withdraw, and more—by command.
  • Pool Management: Create and manage Blend pools programmatically.
  • Risk Analysis: Fetch and analyze pool/user data for safety and investment decisions.
  • Composable Workflows: Chain actions together (e.g., "analyze pool, then lend if safe").
  • AI Assistant Integration: Works with Claude, ChatGPT, or your own custom AI/bot.
  • Extensible: Add new tools for NFTs, bridges, or any Soroban contract.

🛠️ MCP Functions & Tools

Blend MCP exposes the following tools (functions) to any AI assistant or app:

Tool NameDescription
loadPoolDataLoads comprehensive data for a given Blend pool (optionally includes user position).
getTokenBalanceGets the balance of a specific token for a user address.
getFeeStatsGets current Soroban network fee statistics.
getPoolEventsGets historical events for a specific pool.
loadBackstopDataLoads data for the main Blend backstop contract.
loadTokenMetadataLoads metadata for a given token/asset.
simulateOperationSimulates a transaction operation without submitting it.
lendLend (supply collateral) to a pool.
withdrawWithdraw assets from a pool.
borrowBorrow assets from a pool.
repayRepay borrowed assets to a pool.
claimRewardsClaim available rewards from a pool.
createPoolDeploy a new, permissionless lending pool.
addReserveAdd a new asset reserve to a pool.
buyNftBuy an NFT from a Soroban NFT contract using provided funds.

Each tool is accessible via natural language or programmatic calls, and can be combined for advanced workflows.

🔗 Composed Workflows & Advanced Features

Blend MCP's true power is in composability—AI assistants or apps can chain these tools to create advanced DeFi workflows:

  • Risk Analysis:
    1. loadPoolData → loadTokenMetadata → (optional) getPoolEvents → AI summarizes risk.
    2. "Analyze Pool X for risk."
  • Buy Now, Pay Later (BNPL) for NFTs:
    1. borrow → buyNft → (optional) repay later.
    2. "Buy this NFT and let me pay later using Blend."
  • Automated Lending:
    1. loadPoolData → AI checks safety → lend if safe.
    2. "If Pool Y is safe, lend 40% of my XLM."
  • Pool Creation:
    1. createPool → addReserve → (optional) set parameters.
    2. "Create a new pool, add a USDC reserve."
  • Custom DeFi Strategies:
    1. Any combination of the above tools, orchestrated by an AI or app.
    2. "Borrow from Pool Z, buy an NFT, and set up a repayment plan."

🏗️ Architecture

flowchart TD
    User(("User / AI Assistant"))
    MCPServer(["Blend MCP Server"])
    BlendSDK(["Blend Protocol SDK"])
    Stellar(["Stellar Network"])
    NFT(["NFT Contract / dApps"])

    User-->|"Natural Language Command"|MCPServer
    MCPServer-->|"Tool Call (lend, borrow, risk, etc.)"|BlendSDK
    BlendSDK-->|"Soroban Transaction"|Stellar
    MCPServer-->|"Composable Actions"|NFT
    NFT-->|"On-chain Action"|Stellar
    BlendSDK-->|"Data Fetch"|Stellar
    MCPServer-->|"Result (Analysis, Confirmation, etc.)"|User

⚡ Quick Start

A. Direct Usage (No Clone/Build Needed!)

  1. No install required! Use the published npm package with npx:

    {
  "mcpServers": {
    "Blend Protocol MCP": {
      "command": "npx",
      "args": [
        "blend-mcp-stellar"
      ],
      "env": {
        "AGENT_SECRET": "<YOUR_STELLAR_SECRET_KEY>",
        "RPC_URL": "https://soroban-testnet.stellar.org",
        "BACKSTOP_ID_V2": "<OPTIONAL_BACKSTOP_ID_V2>",
        "POOL_FACTORY_ID": "<OPTIONAL_POOL_FACTORY_ID>"
      }
    }
  }
}
    • Save as .cursor/mcp.json (for most MCP clients) or claude_desktop_config.json (for Claude Desktop).
    • Just add your agent secret!

  2. Run your AI assistant (Claude, ChatGPT, or any MCP-compatible client) and connect using the config above.

B. Local Setup (for development)

  1. Clone the repo: 
    git clone [your-repo-url]
cd BlendMcp
yarn install # or npm install
  2. Set your environment variables:
    • AGENT_SECRET (your Stellar secret key for signing transactions)
    • (Optional) POOL_FACTORY_ID, BACKSTOP_ID, etc. for advanced features
  3. Build and run: 
    npm run build
# then run your MCP server as needed

🤖 How to Connect Your AI Assistant

🛠️ Contributing

  • PRs and issues welcome! This project will be in active development even after the stellar blend hackathon.
  • Want to add a new tool or integration? Open an issue or PR.

📬 Contact

📝 Notes

  • Got 2 offers to sell this project ($2800 and $1900)

  • it is built for blend ecosystem

  • Blend MCP is under active development. More features and integrations are coming soon!

  • Built for the Stellar Blend hackathon, but designed for long-term extensibility and composability.

Related Servers