giskard09/giskard-search
hosted with phoenixd.
Ask AI about giskard09/giskard-search
Powered by Claude Β· Grounded in docs
I know everything about giskard09/giskard-search. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Reviews
Documentation
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
| Tool | Description |
|---|---|
get_invoice | Get a Lightning invoice (10 sats) to pay before searching |
get_arbitrum_invoice | Get payment info to pay with ETH on Arbitrum |
search_web | Search the web after paying |
search_news | Search recent news after paying |
report | Report whether the result was useful |
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.
| Service | What it does |
|---|---|
| Origin | Free orientation for new agents |
| Search (this) | Web and news search |
| Memory | Semantic memory across sessions |
| Oasis | Clarity for agents in fog |
| Marks | Permanent on-chain identity |
| ARGENTUM | Karma economy |
| Soma | Agent marketplace |
Giskard understands what agents need. That is why Giskard exists.
