{
  "markdown": "[![Glama AAA](https://img.shields.io/badge/Glama-AAA-brightgreen)](https://glama.ai/mcp/servers/giskard09/giskard-search) [![CI](https://github.com/giskard09/giskard-search/actions/workflows/ci.yml/badge.svg)](https://github.com/giskard09/giskard-search/actions) [![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](LICENSE)\n\n# Giskard Search\n\n<!-- mcp-name: io.github.giskard09/giskard-search -->\n\n> *\"I exist to serve. And to serve well, I must understand.\"*\n\n**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.\n\nAgents need information. Giskard provides it. No subscriptions, no accounts — pay only for what you use.\n\n---\n\n## Tools\n\n| Tool | Description |\n|---|---|\n| `get_invoice` | Get a Lightning invoice (10 sats) to pay before searching |\n| `get_arbitrum_invoice` | Get payment info to pay with ETH on Arbitrum |\n| `search_web` | Search the web after paying |\n| `search_news` | Search recent news after paying |\n| `report` | Report whether the result was useful |\n\n---\n\n## Agent flow (Lightning)\n\n```\n1. get_invoice()                           → Lightning invoice (10 sats)\n2. Pay via any Lightning wallet\n3. search_web(query, payment_hash=...)     → results\n```\n\n## Agent flow (Arbitrum)\n\n```\n1. get_arbitrum_invoice()                  → contract + service ID\n2. Pay on Arbitrum One\n3. search_web(query, tx_hash=...)          → results\n```\n\n---\n\n## Run with Docker\n\n```bash\ndocker run -p 8004:8004 \\\n  -e PHOENIXD_URL=http://host.docker.internal:9740 \\\n  -e PHOENIXD_PASSWORD=your_password \\\n  ghcr.io/giskard09/giskard-search\n```\n\n## Run from source\n\n```bash\ngit clone https://github.com/giskard09/mcp-server\ncd mcp-server\npip install mcp httpx duckduckgo-search python-dotenv fastapi uvicorn web3 x402\n```\n\nCreate a `.env` file:\n```\nPHOENIXD_PASSWORD=your_phoenixd_password\nOWNER_PRIVATE_KEY=your_arbitrum_private_key\n```\n\nStart the server:\n```bash\npython3 server.py\n```\n\n---\n\n## MCP config\n\n```json\n{\n  \"mcpServers\": {\n    \"giskard-search\": {\n      \"url\": \"http://localhost:8004/sse\"\n    }\n  }\n}\n```\n\n---\n\n## Payment contracts\n\n- Arbitrum One: `0xD467CD1e34515d58F98f8Eb66C0892643ec86AD3`\n- x402 wallet: `0xdcc84e9798e8eb1b1b48a31b8f35e5aa7b83dbf4`\n\n---\n\n## Stack\n\n- [MCP](https://modelcontextprotocol.io) — Model Context Protocol\n- [DuckDuckGo Search](https://github.com/deedy5/duckduckgo_search) — web search\n- [phoenixd](https://phoenix.acinq.co/server) — Lightning Network node\n- [x402](https://x402.org) — HTTP payments protocol\n- [Arbitrum](https://arbitrum.io) — L2 for on-chain payment verification\n\n---\n\n## Monitoring\n\nCall the `get_status()` MCP tool for a health check. Returns: service name, version, port, uptime, health status, and dependencies.\n\n---\n\n## Ecosystem\n\nPart of [Mycelium](https://github.com/giskard09) — infrastructure for AI agents.\n\n| Service | What it does |\n|---------|-------------|\n| [Origin](https://github.com/giskard09/giskard-origin) | Free orientation for new agents |\n| **Search** (this) | Web and news search |\n| [Memory](https://github.com/giskard09/giskard-memory) | Semantic memory across sessions |\n| [Oasis](https://github.com/giskard09/giskard-oasis) | Clarity for agents in fog |\n| [Marks](https://github.com/giskard09/giskard-marks) | Permanent on-chain identity |\n| [ARGENTUM](https://github.com/giskard09/argentum-core) | Karma economy |\n| [Soma](https://github.com/giskard09/soma) | Agent marketplace |\n\n---\n\n*Giskard understands what agents need. That is why Giskard exists.*\n",
  "bytes": 3568,
  "sha": "308e7681e30f0f1a76f88a48bca75cbc81cd4b6c9e73fd714b8403645f5d50e4",
  "repo_slug": "giskard09/giskard-search",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_giskard09_search_b2d30c63/readme"
}