Giskard Search

<!-- mcp-name: io.github.giskard09/giskard-search -->

"I exist to serve. And to serve well, I must understand."

Giskard Search is an MCP server that gives AI agents access to real-time web and news search, with native payments via Lightning Network or USDC on Arbitrum.

Agents need information. Giskard provides it. No subscriptions, no accounts — pay only for what you use.

Tools

Agent flow (Lightning)

1. get_invoice()                           → Lightning invoice (10 sats)
2. Pay via any Lightning wallet
3. search_web(query, payment_hash=...)     → results

Agent flow (Arbitrum)

1. get_arbitrum_invoice()                  → contract + service ID
2. Pay on Arbitrum One
3. search_web(query, tx_hash=...)          → results

Run with Docker

docker run -p 8004:8004 \
  -e PHOENIXD_URL=http://host.docker.internal:9740 \
  -e PHOENIXD_PASSWORD=your_password \
  ghcr.io/giskard09/giskard-search

Run from source

git clone https://github.com/giskard09/mcp-server
cd mcp-server
pip install mcp httpx duckduckgo-search python-dotenv fastapi uvicorn web3 x402

Create a .env file:

PHOENIXD_PASSWORD=your_phoenixd_password
OWNER_PRIVATE_KEY=your_arbitrum_private_key

Start the server:

python3 server.py

MCP config

{
  "mcpServers": {
    "giskard-search": {
      "url": "http://localhost:8004/sse"
    }
  }
}

Payment contracts

• Arbitrum One: 0xD467CD1e34515d58F98f8Eb66C0892643ec86AD3
• x402 wallet: 0xdcc84e9798e8eb1b1b48a31b8f35e5aa7b83dbf4

Stack

• MCP — Model Context Protocol
• DuckDuckGo Search — web search
• phoenixd — Lightning Network node
• x402 — HTTP payments protocol
• Arbitrum — L2 for on-chain payment verification

Monitoring

Call the get_status() MCP tool for a health check. Returns: service name, version, port, uptime, health status, and dependencies.

Ecosystem

Part of Mycelium — infrastructure for AI agents.

Giskard understands what agents need. That is why Giskard exists.