Frequently Asked Questions (FAQ) about MCP Server for Gotas Commerce

Q: What is the MCP Server for Gotas Commerce? A: It’s a bridge that allows AI agents like Claude to create and verify USDT transactions through the Gotas Commerce API, using the Model Context Protocol (MCP).

Q: What is MCP (Model Context Protocol)? A: MCP is an open protocol standardizing how applications provide context to LLMs, enabling AI models to interact with external data and tools.

Q: What cryptocurrencies are supported? A: Currently, only USDT (Tether) is supported.

Q: What is Gotas Commerce API? A: An API for managing cryptocurrency payments, providing endpoints for creating and checking payment statuses.

Q: What tools are provided by the MCP Server? A: The server provides create-payment to generate payments and check-payment-status to verify the status of a payment.

Q: How do I install the MCP Server? A: Clone the repository, install the requirements using pip install -r requirements.txt, configure the .env file with your Gotas API key, and run the server using uvicorn src.gotas_mcp_server:app --host 0.0.0.0 --port 8000.

Q: Where do I get the Gotas Commerce API Key? A: You can obtain the API key from commerce.gotas.com.

Q: How does the create-payment tool work? A: It takes parameters like amount, currency, return URL, and description and returns a JSON object with payment details like ID, payment URL, and wallet address.

Q: What information does the check-payment-status tool provide? A: It returns the payment’s current status (pending, completed, failed, expired), timestamps, and the blockchain transaction hash (if confirmed).

Q: What is the payment-status://{payment_id} resource? A: It’s a formatted text version of the payment status, including ID, status, value, timestamps, and description.

Q: Can I use this with Claude Desktop? A: Yes, use python install_claude.py to install the MCP Server with Claude Desktop, or manually install using mcp install src.gotas_mcp_server.py.

Q: How do I test the server directly without an AI assistant? A: Use the test_client.py script to create payments and check_payment.py to verify payment statuses.

Q: How is the API key secured? A: The API key is stored as an environment variable, not in the code.

Q: Is the communication secure? A: Yes, communication with the Gotas Commerce API is done via HTTPS, and the MCP Server validates all parameters.

Q: Can I extend the functionality of the MCP Server? A: Yes, you can add new MCP tools by implementing functions decorated with @mcp.tool() in the server.

Q: Can the MCP Server integrate with services other than Gotas Commerce? A: Yes, the architecture allows integrating other services easily.

Q: How can I get support or contact the development team? A: Contact the Gotas development team or open an issue on the GitHub repository.

Q: How does this integrate with UBOS Platform? A: Integrating the MCP Server for Gotas Commerce with the UBOS platform allows you to build AI agents that can not only process information and make decisions but also execute financial transactions, all within a secure and governed environment.