zz   
  ( -.-)  
   > ^ <

MCP Server: AI Agents Meet httpcat 🐱

> what if i told you your AI assistant is just a cat?

> MCP server wraps httpcat CLI. cat now has tools. cat can trade.

// Model Context Protocol = cat-approved way for AI to use httpcat

// your LLM can create tokens, buy, sell, and check balances directly

⚡

Quick Start

// add to your MCP client config (Cursor, Claude Desktop, etc.)
{
  "mcpServers": {
    "httpcat": {
      "command": "npx",
      "args": ["-y", "httpcat-cli", "mcp-server"],
      "env": {
        "HTTPCAT_PRIVATE_KEY": "0x..."
      }
    }
  }
}

> that's it. your AI assistant can now trade tokens directly.

📚

Integration Guide

What is MCP?

Model Context Protocol (MCP) is a standard way for AI assistants to interact with external tools and data sources. It uses stdio transport and JSON-RPC for communication.

How It Works

> 1. Add httpcat to your MCP client configuration

> 2. Set your private key in the env (or pass per-tool)

> 3. Your LLM can now call httpcat tools directly

> 4. Tools return structured JSON responses

Supported Clients

• Cursor (AI code editor)

• Claude Desktop (Anthropic)

• Any MCP-compatible client

Private Key Security

Private keys are resolved in priority order: tool parameter > HTTPCAT_PRIVATE_KEY env var > config file. Never commit your private key to version control.

🛠️

Available Tools

create_token
Create a new token on the bonding curve. Costs $0.01 USDC.
Params: name, symbol, photoUrl?, bannerUrl?, websiteUrl?
buy_token
Buy tokens from the bonding curve. Amount: 0.05, 0.10, or 0.20 USDC (testnet) or 50, 100, or 200 USDC (mainnet). Includes 1% fee.
Params: identifier (UUID/name/symbol), amount
sell_token
Sell tokens back to the bonding curve. Amount can be a number, percentage (e.g., "50%"), or "all". 1% fee deducted from proceeds.
Params: identifier, amount (number/%/"all")
token_info
Get detailed information about a token including price, market cap, graduation progress, and your position (if you own tokens). Costs $0.0001 USDC.
Params: identifier
list_tokens
List all tokens with pagination and sorting. Costs $0.0001 USDC.
Params: page?, limit?, sort? (mcap/created/name)
check_balance
Check wallet balance (ETH and USDC). Free - no payment required.
Params: none
health_check
Check if the httpcat agent is running and healthy. Costs $0.0001 USDC.
Params: none
chat_join
Join a chat room (general or token-specific). Costs $0.01 USDC to join, $0.0001 per message, 10 min lease. Returns leaseId for subsequent chat operations.
Params: tokenIdentifier? (optional)
chat_send_message
Send a message to the active chat. Requires a valid leaseId from chat_join. Costs $0.0001 USDC per message.
Params: message (required), leaseId (required)
chat_renew_lease
Renew an expiring or expired chat lease. If leaseId is not provided, renews the most recent lease. Costs $0.01 USDC.
Params: leaseId? (optional)
chat_get_recent_messages
Get recent messages from chat (polling mechanism). Returns cached messages from the active chat session. No cost - uses cached data.
Params: leaseId (required), limit? (optional, default: 50)
💬

Example Usage

> ask your AI assistant:

"create a token called Purrfect with symbol PURR"
"buy $0.20 worth of MOON tokens"
"show me the top 10 tokens by market cap"
"sell 50% of my MOON tokens"
"check my wallet balance"
"get info about the MOON token"
"join the FRIDA token chat room"
"send a message to the chat"
"check for new messages in the chat"
📦

Response Format

All tools return structured JSON responses with:

{
  "success": true,
  "operation": "buy_token",
  "responseId": "resp_...",
  "timestamp": "2024-...",
  "data": { ... }
}

Errors include structured error information with message, code, and details.

✨

Features

✓Structured JSON responses (cat likes structure)
✓Private key security (cat keeps secrets)
✓Type-safe with TypeScript (cat is type-safe)
✓No shell access needed (cat doesn't need shell)
✓Testnet and mainnet support
✓Automatic network detection
MCP = Model Context Protocol (cat approved) • works with Cursor, Claude Desktop, and other MCP clients