@stellar-agent/mcp-server
v0.5.2
Published
MCP stdio server that exposes Stellar Agent Bridge CLI workflows as agent tools.
Readme
@stellar-agent/mcp-server
MCP stdio server for stellar-agent.
The server exposes agent-safe tools for the existing CLI workflows instead of duplicating payment logic. Tools include Testnet init/doctor/Friendbot funding, issued-asset and contract-asset smoke scenarios, wallet creation and balances, trustline add/remove, fee-aware payment quote/send, guarded Testnet batch payments, local x402 and MPP HTTP payments, claimable balance create/list/claim, core Stellar liquidity-pool list/inspect/trade/position/preflight/listener workflows, strategy liquidity investigation, and Stellar CLI-backed contract operations including asset deploy, info, read, fetch, invoke, upload, deploy, extend, and restore.
Install
npm install @stellar-agent/mcp-serverRun
Build and run from a checkout:
pnpm build
STELLAR_AGENT_CLI=packages/cli/dist/index.js node packages/mcp-server/dist/server.jsWhen installed globally, stellar-agent-mcp uses the stellar-agent binary by default. Set STELLAR_AGENT_CLI=/path/to/stellar-agent or STELLAR_AGENT_CLI=/path/to/packages/cli/dist/index.js to override it.
Every tool calls stellar-agent --json and returns the parsed JSON output plus the CLI exit code.
Safety
The MCP server delegates to the CLI so policy checks, Mainnet guards, redaction, and receipt behavior stay centralized. Tools should stop on requires_approval unless the user explicitly approves the guarded flow.
Links
- GitHub: https://github.com/someone-in-texas/Stellar-Agent
- Agent integration docs: https://github.com/someone-in-texas/Stellar-Agent/blob/main/docs/agent-integration.md
- Codex plugin docs: https://github.com/someone-in-texas/Stellar-Agent/blob/main/docs/codex-plugin.md
