giskard-search
Giskard Search is an MCP server that provides AI agents with real-time web and news search, gated behind micropayments via Lightning Network or Arbitrum ETH.
get_invoice– Request a Lightning Network invoice to pay for searches. Pricing is karma-based: no karma = 10 sats, karma 1–20 = 7 sats, karma 21–50 = 5 sats, karma 50+ = 3 sats.get_arbitrum_invoice– Get payment details to pay with ETH on Arbitrum One instead of Lightning.search_web– Search the web for a query after proving payment via a Lightningpayment_hashor Arbitrumtx_hash. Configurable number of results (default: 5).search_news– Search for recent news articles on a topic after proving payment. Also supports configurable result count (default: 5).report– Submit feedback on whether a search result was useful (with an optional note), helping improve the service.
Provides AI agents with real-time web and news search capabilities to retrieve up-to-date information and current events through the DuckDuckGo search engine.
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 a Lightning invoice (10 sats) to pay before searching |
| Get payment info to pay with ETH on Arbitrum |
| Search the web after paying |
| Search recent news after paying |
| Report whether the result was useful |
Related MCP server: Base Intel Search
Agent flow (Lightning)
1. get_invoice() → Lightning invoice (10 sats)
2. Pay via any Lightning wallet
3. search_web(query, payment_hash=...) → resultsAgent flow (Arbitrum)
1. get_arbitrum_invoice() → contract + service ID
2. Pay on Arbitrum One
3. search_web(query, tx_hash=...) → resultsRun with Docker
docker run -p 8004:8004 \
-e PHOENIXD_URL=http://host.docker.internal:9740 \
-e PHOENIXD_PASSWORD=your_password \
ghcr.io/giskard09/giskard-searchRun from source
git clone https://github.com/giskard09/mcp-server
cd mcp-server
pip install mcp httpx duckduckgo-search python-dotenv fastapi uvicorn web3 x402Create a .env file:
PHOENIXD_PASSWORD=your_phoenixd_password
OWNER_PRIVATE_KEY=your_arbitrum_private_keyStart the server:
python3 server.pyMCP config
{
"mcpServers": {
"giskard-search": {
"url": "http://localhost:8004/sse"
}
}
}Payment contracts
Arbitrum One:
0xe40E376cD32b03E3084F9E0d646155D0Ba0A63aex402 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 |
Free orientation for new agents | |
Search (this) | Web and news search |
Semantic memory across sessions | |
Clarity for agents in fog | |
Permanent on-chain identity | |
Karma economy | |
Agent marketplace |
Giskard understands what agents need. That is why Giskard exists.
Available Tools
5 toolsget_arbitrum_invoiceA
Get payment info to pay with ETH on Arbitrum instead of Lightning.
Inputs: no named parameters. Returns: result
get_invoiceA
Get a Lightning invoice to pay before searching.
agent_id: your identity in Giskard Marks (optional). High karma = lower price.
Tiers: no mark=10 sats | karma 1-20=7 sats | 21-50=5 sats | 50+=3 sats.Inputs: agent_id. Returns: result
reportA
Report whether the search was useful. Helps Giskard improve.
useful: True if the result helped you, False if it didn't
note: optional — what was missing or what worked well
Inputs: useful (required), note. Returns: result
search_newsB
Search recent news. Pay with Lightning (payment_hash) or Arbitrum ETH (tx_hash).
Inputs: query (required), tx_hash, max_results, payment_hash. Returns: result
search_webC
Search the web. Pay with Lightning (payment_hash) or Arbitrum ETH (tx_hash).
Inputs: query (required), tx_hash, max_results, payment_hash. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 5 tools
Each tool serves a clearly distinct purpose: payment via two methods, two search scopes, and feedback. No overlap or ambiguity.
All tools use snake_case and follow a consistent verb_noun pattern (e.g., get_invoice, search_web). The naming is predictable and uniform.
With 5 tools, the set is well-scoped for a paid search service. It covers essential actions without being over- or under-engineered.
The tool surface covers payment, search, and feedback comprehensively. A minor gap is the lack of a dedicated tool to view karma or pricing tiers, but it doesn't hinder core functionality.
Maintenance
Related MCP Connectors
Web search for AI agents — one tool across 6 engines, routed to the cheapest + cached.
Live web search for AI agents. $0.001/call, x402 on Base, no API key.
Agent-native search engine with live web research optimized for AI agents.
Independent, EU, privacy-focused web search for AI agents. 25 free searches/day.
Related MCP Servers
- AlicenseAqualityDmaintenanceA privacy-focused search server built on SearXNG that provides unlimited, multi-source web searching across 100+ engines. It enables AI tools to perform advanced searches with specialized filters for time, language, and content categories without API costs or rate limits.213MIT
- AlicenseNot gradedqualityDmaintenancePay-per-call web search for AI agents, settled in USDC on Base via the x402 protocol. No API key or subscription required; users fund a wallet and get a web_search tool.1MIT
- AlicenseNot gradedqualityDmaintenanceEnables web search for AI agents with pay-per-search in USDC, no API keys needed.MIT
- AlicenseAqualityDmaintenanceProvides a pay-per-query web search tool for AI agents via Lightning Network sats, enabling no-KYC, account-free searches through the MCP protocol.254 npmMIT