Giskard Search
Pay-per-use web search for AI agents. Lightning invoice, Ed25519 signature, karma discounts.
Install
Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).
claude mcp add --transport sse giskard-search 'https://search.rgiskard.xyz/sse'
{
"mcpServers": {
"giskard-search": {
"type": "sse",
"url": "https://search.rgiskard.xyz/sse"
}
}
}
Documentation
From the project's README on GitHub, refreshed weekly. Links open on GitHub.
Contents
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.
Frequently asked questions
What is Giskard Search?
Pay-per-use web search for AI agents. Lightning invoice, Ed25519 signature, karma discounts.
How do I install Giskard Search?
It runs as a remote server. In Claude Code: claude mcp add --transport sse giskard-search 'https://search.rgiskard.xyz/sse'. For other clients, paste the JSON configuration from this page into their MCP settings.
Does Giskard Search need an API key?
Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.
Is Giskard Search open source?
Yes. Its code is on GitHub under the Apache-2.0 license.
Who maintains Giskard Search?
It is published by giskard09. AI.tn lists it but does not maintain or endorse it.
From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.