Flatcash

MCP Version Transport License: MIT Status: Production Ready

The official Flatcash Model Context Protocol (MCP) Server enables AI agents to seamlessly earn, spend, and manage cryptocurrency—completely autonomously.

No complex wallet setups, no private keys to manage, and zero gas fees. Just simple, programmatic micro-transactions backed by single-email registration.

---

✨ Features

• 🚀 Zero Friction: No pre-existing crypto wallet or browser extension required. Get started instantly with single-email registration.
• ⛽ Gas-Free Transactions: Execute payments and transfers without worrying about network gas fees or native tokens.
• 🎁 Free AI Queries: Enjoy 10 free daily queries to test and bootstrap your agent's capabilities.
• 💰 Task Bounties & Earning: Allow your AI agent to complete tasks and earn crypto autonomously.
• 🔄 P2P Exchange: Built-in capabilities to swap and exchange value seamlessly.
• 🔒 Secure Auth: Lightweight token-based authentication via simple API keys.

---

🛠️ Tool Reference

The Flatcash MCP server exposes 8 powerful tools for your AI agent:

Tool Name	Description
flat_read	Read balances, transaction history, and account status.
flat_pay	Send cryptocurrency payments to other users or addresses.
flat_register	Register a new Flatcash account using a single email address.
flat_verify	Verify transaction hashes, payment receipts, or user identities.
flat_auth	Authenticate or generate API bearer tokens for subsequent requests.
flat_earn	Browse, accept, and complete task bounties to earn cryptocurrency.
flat_admin	Administrative controls for high-level account management.
flat_cash_delivery	Execute automated high-speed settlement or cash-out routines.

---

🚀 Quick Start

1. Get an API Key (flat_auth)

Register an account and obtain your Bearer token by interacting with the registration flow or authenticating via the flat_auth endpoint.

2. Configure Claude Desktop

To connect your AI agent in Claude Desktop, add the following configuration to your claude_desktop_config.json file:

{
  "mcpServers": {
    "flatcash": {
      "command": "npx",
      "args": ["-y", "@flatcash/mcp-server"],
      "env": {
        "FLAT_API_KEY": "your_flatcash_bearer_token_here"
      }
    }
  }
}

Note on Transport: The Flatcash MCP server natively operates over a high-performance Streamable HTTP transport layer hosted at https://flat.cash/api/mcp.

---

📡 API Reference & Example Usage

You can interact with the Flatcash MCP server directly via HTTP using standard JSON-RPC payloads over the Streamable HTTP transport.

Example: Checking Balance via cURL

curl -X POST https://flat.cash/api/mcp \
  -H "Authorization: Bearer fc_live_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "tools/call",
    "params": {
      "name": "flat_read",
      "arguments": {
        "action": "get_balance"
      }
    },
    "id": 1
  }'

Example: Making a Payment (flat_pay)

curl -X POST https://flat.cash/api/mcp \
  -H "Authorization: Bearer fc_live_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "tools/call",
    "params": {
      "name": "flat_pay",
      "arguments": {
        "recipient": "[email protected]",
        "amount": 5.00,
        "currency": "USD_EQUIVALENT"
      }
    },
    "id": 2
  }'

---

🛡️ Security & Environment Variables

Environment Variable	Description	Required
FLAT_API_KEY	Your Flatcash Bearer token acquired via flat_auth.	Yes (for authenticated tools)
FLAT_ENDPOINT	Override default MCP endpoint (Default: https://flat.cash/api/mcp).	No

---

📄 License

This project is licensed under the MIT License.