Stellar MCP

Overview

A Model Context Protocol server that provides Stellar blockchain interaction capabilities.

Components# Tools\n\n#### Stellar Classic Operations

• stellar_create_account: Create a new Stellar account
• stellar_balance: Get the balance of a Stellar account
• stellar_payment: Send a payment to another account
• stellar_transactions: Get transaction history for an account
• stellar_create_asset: Create a new asset on the Stellar network
• stellar_change_trust: Change trustline for an asset
• stellar_create_claimable_balance: Create a claimable balance
• stellar_claim_claimable_balance: Claim a claimable balance using its ID
• stellar_fund_account: Fund a test account using the Friendbot (testnet only)

Soroban Smart Contract Operations

• soroban_build_and_optimize: Build and optimize Soroban smart contracts
• soroban_deploy: Deploy Soroban smart contracts to the Stellar network
• soroban_retrieve_contract_methods: Retrieve the complete interface of a deployed Soroban smart contract

Key Features

• Account management (creation, funding, balance checking)
• Asset operations (creation, trustlines)
• Payment processing
• Transaction history retrieval
• Smart contract deployment and interaction
• Support for both Stellar Classic and Soroban

Configuration# Environment Variables

Create a .env file with the following configuration:

STELLAR_SERVER_URL=
```\n\n### Configuration to use Stellar MCP Server## Local
```json
{
  "mcpServers": {
    "stellar-mcp": {
      "command": "node",
      "args": ["your/path/stellar-mcp/dist/index.js"]
    }
  }
}
```\n\n#### NPX
```json
{
  "mcpServers": {
    "stellar-mcp": {
      "command": "npx",
      "args": ["-y", "stellar-mcp"]
    }
  }
}
```\n\n#### Docker
```json
{
  "mcpServers": {
    "stellar": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "--init", "-e", "STELLAR_SERVER_URL=", "stellar-mcp"]
    }
  }
}
```\n\n### Installation
```bash
npm install
```\n\n### Build
```bash
npm run build
```\n\n### Run Development
```bash
npm run start:dev
```\n\n### Run Production
```bash
npm run start:prod
```\n\n## License
This MCP server is licensed under the MIT License.