Giskard Search
Pay-per-use web search for AI agents. Lightning invoice, Ed25519 signature, karma discounts.
التثبيت
أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: .cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).
claude mcp add --transport sse giskard-search 'https://search.rgiskard.xyz/sse'
{
"mcpServers": {
"giskard-search": {
"type": "sse",
"url": "https://search.rgiskard.xyz/sse"
}
}
}
التوثيق
مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.
المحتويات
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.
الأسئلة الشائعة
ما هو Giskard Search؟
Pay-per-use web search for AI agents. Lightning invoice, Ed25519 signature, karma discounts.
كيف أثبّت Giskard Search؟
يعمل كخادم بعيد. في Claude Code: claude mcp add --transport sse giskard-search 'https://search.rgiskard.xyz/sse'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.
هل يحتاج Giskard Search إلى مفتاح API؟
لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.
هل Giskard Search مفتوح المصدر؟
نعم. شيفرته متاحة على GitHub بترخيص Apache-2.0.
من يصون Giskard Search؟
ينشره giskard09. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.
من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.