Giskard Search
Pay-per-use web search for AI agents. Lightning invoice, Ed25519 signature, karma discounts.
Open source Repository Open in the app JSON README (API)
About
Pay-per-use web search for AI agents. Lightning invoice, Ed25519 signature, karma discounts.
Details
- Kind
- MCP servers
- Topic
- Finance & crypto
- Publisher
- giskard09
- Origin
- official
- Category
- ferramentas
- Transport
- sse
- Version
- 0.1.1
- Stars
- 1
- Last push
- 2026-06-22T12:57:48Z
- Repository state
- ativo
- Language
- Python
- License
- Apache-2.0
- Added
- 2026-08-29 03:02:51
- Updated
- 2026-08-29 03:02:51
- Origin id
io.github.giskard09/search
README
[](https://glama.ai/mcp/servers/giskard09/giskard-search) [](https://github.com/giskard09/giskard-search/actions) [](LICENSE)
# 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
| 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
```bash
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
```bash
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:
```bash
python3 server.py
```
---
## MCP config
```json
{
"mcpServers": {
"giskard-search": {
"url": "http://localhost:8004/sse"
}
}
}
```
---
## Payment contracts
- Arbitrum One: `0xD467CD1e34515d58F98f8Eb66C0892643ec86AD3`
- x402 wallet: `0xdcc84e9798e8eb1b1b48a31b8f35e5aa7b83dbf4`
---
## Stack
- [MCP](https://modelcontextprotocol.io) — Model Context Protocol
- [DuckDuckGo Search](https://github.com/deedy5/duckduckgo_search) — web search
- [phoenixd](https://phoenix.acinq.co/server) — Lightning Network node
- [x402](https://x402.org) — HTTP payments protocol
- [Arbitrum](https://arbitrum.io) — 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](https://github.com/giskard09) — infrastructure for AI agents.
| Service | What it does |
|---------|-------------|
| [Origin](https://github.com/giskard09/giskard-origin) | Free orientation for new agents |
| **Search** (this) | Web and news search |
| [Memory](https://github.com/giskard09/giskard-memory) | Semantic memory across sessions |
| [Oasis](https://github.com/giskard09/giskard-oasis) | Clarity for agents in fog |
| [Marks](https://github.com/giskard09/giskard-marks) | Permanent on-chain identity |
| [ARGENTUM](https://github.com/giskard09/argentum-core) | Karma economy |
| [Soma](https://github.com/giskard09/soma) | Agent marketplace |
---
*Giskard understands what agents need. That is why Giskard exists.*