home / mcp / gotas commerce mcp server

Gotas Commerce MCP Server

Provides an MCP bridge to Gotas Commerce USDT payments enabling creation, status checks, and simplified payment summaries.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "caiovicentino-mcpgotas": {
      "command": "uvicorn",
      "args": [
        "src.gotas_mcp_server:app",
        "--host",
        "0.0.0.0",
        "--port",
        "8000"
      ],
      "env": {
        "GOTAS_API_KEY": "YOUR_API_KEY",
        "GOTAS_BASE_URL": "https://commerce.gotas.com"
      }
    }
  }
}

You can run a dedicated MCP server that bridges IA assistants with Gotas Commerce USDT payments. This server exposes MCP tools to create and verify payments, letting your AI workflows generate payment links, monitor status, and retrieve transaction details without needing blockchain expertise.

How to use

Use the MCP server from an MCP client to access the payment tools. The server exposes an intuitive set of MCP endpoints that let you create a USDT payment, check its status, and present a concise summary of each payment. You can drive these actions from an IA assistant or any MCP-enabled client.

How to install

Prerequisites: ensure you have Python 3.8 or newer installed on your system.

Install and run the MCP server using the following steps. Copy each command exactly as shown.

git clone https://github.com/caiovicentino/mcpgotas.git
cd mcpgotas

pip install -r requirements.txt

# Alternative automated setup (if provided in your workflow) can be used as needed
./setup.bat

# Create environment file with your credentials
# GOTAS_API_KEY=your_api_key
# GOTAS_BASE_URL=https://commerce.gotas.com

# Start the MCP server (Python-based FastAPI with Uvicorn)
uvicorn src.gotas_mcp_server:app --host 0.0.0.0 --port 8000
```]}]},{

Additional sections

Configuration and security: The API key and base URL are provided as environment variables. Store these values securely and avoid committing them to version control.

Usage notes: The MCP server renders tools for IA-assisted payment creation, status checks, and a formatted payment status resource. You can expose these tools to Claude or other MCP-enabled assistants in your environment.

Troubleshooting: If the server fails to start, verify that Python 3.8+ is installed, your environment variables are set, and that port 8000 is not in use. Check that the required dependencies from requirements.txt are installed.

Available tools

create-payment

Creates a new USDT payment and returns all required details including payment URL and wallet address.

check-payment-status

Checks the current status of an existing payment by its unique ID.

payment-status

Provides a simplified, formatted status view of the payment as an MCP resource.

create-payment-prompt

Guided prompt to collect information needed to create a new payment.