Frequently Asked Questions (FAQ) about Stellar MCP Server

Q: What is the Stellar MCP Server?

A: The Stellar MCP Server is an implementation of the Model Context Protocol (MCP) designed to allow AI agents and Large Language Models (LLMs) to interact with the Stellar blockchain. It provides a standardized interface for performing Stellar blockchain operations.

Q: What is MCP?

A: MCP stands for Model Context Protocol. It is an open protocol that standardizes how applications provide context to LLMs, enabling AI models to access and interact with external data sources and tools.

Q: Why use Stellar MCP?

A: Stellar MCP allows AI agents to directly access Stellar blockchain functionality, enabling them to create and manage Stellar accounts, fund accounts with testnet lumens, fetch account information and transaction history, sign and submit Soroban smart contract transactions, and interact with Passkey wallets.

Q: What are the key features of the Stellar MCP Server?

A: Key features include account management (creation, funding, details), transaction operations (viewing history, signing Soroban transactions, supporting various wallets), and smart contract integration (interaction, authorization handling).

Q: What are the prerequisites for installing the Stellar MCP Server?

A: The prerequisites include Node.js (v16 or higher), npm or yarn, and a Stellar testnet account for testing.

Q: How do I install the Stellar MCP Server?

A: You can install the server directly from npm or clone the repository from source and install dependencies using npm install.

Q: What environment variables are required to configure the server?

A: Required environment variables include NETWORK_PASSPHRASE, RPC_URL, LAUNCHTUBE_URL, LAUNCHTUBE_JWT, MERCURY_URL, MERCURY_JWT, MERCURY_PROJECT_NAME, WALLET_WASM_HASH, AGENT_KEYPAIR_FILE_PATH, and USAGE_GUIDE_FILE_PATH.

Q: How do I run the server?

A: After installing the dependencies and configuring the environment variables, you can run the server using npm run build followed by node build/mcp-server.js.

Q: How can I connect the MCP server to Claude Desktop?

A: Add a server configuration to your Claude Desktop config file (~/Library/Application Support/Claude/claude_desktop_config.json) with the appropriate command, arguments, and environment variables.

Q: What are some usage examples for the Stellar MCP Server?

A: Usage examples include creating a new Stellar account, funding an account with testnet lumens, fetching account information, and submitting a Soroban transaction.

Q: How does the sign-and-submit-transaction tool handle smart contract transactions?

A: The sign-and-submit-transaction tool accepts pre-assembled transaction XDRs from Soroban contract invocations, handles proper transaction signing, manages transaction submission, and provides detailed error handling. It supports both standard Stellar accounts and smart wallet implementations.

Q: What key components are included in the Stellar MCP Server?

A: Key components include the MCP Server (mcp-server.ts) which exposes Stellar blockchain functionality through MCP tools, and utilities (utils.ts) which provide helper functions for Passkey wallet integration, transaction signing, and resource file handling.

Q: How can I contribute to the project?

A: Contributions are welcome! Please feel free to submit a Pull Request in the GitHub repository.

Q: Where can I find support for the Stellar MCP Server?

A: For questions and support, please open an issue in the GitHub repository.

Q: How does the Stellar MCP server integrate with the UBOS Platform?

A: The Stellar MCP Server can be integrated with the UBOS platform to leverage additional functionalities, such as agent orchestration, data integration, and custom AI agent development. UBOS provides a comprehensive suite of tools for building, deploying, and managing AI agents, enhancing the capabilities of the Stellar MCP Server.