Giskard Search
Pay-per-use web search for AI agents. Lightning invoice, Ed25519 signature, karma discounts.
¿Debería usar esto?
Calidad y seguridad
Basado en el análisis automatizado de las definiciones de herramientas y el cumplimiento del protocolo.
Costo de contexto
Este es el número aproximado de tokens que se consumen cada vez que las herramientas del servidor se cargan en el contexto de un modelo. Los recuentos más altos reducen la atención disponible para otras tareas.
Instalar
Instalación con un clic
Agrega esto a tu archivo `claude_desktop_config.json`:
{
"mcpServers": {
"search": {
"url": "https://search.rgiskard.xyz/sse"
}
}
}Puntos de conexión remotos
https://search.rgiskard.xyz/ssesseQué puede hacer
Inventario de herramientas
Herramientas (6)
🟢get_status
Estado del servicio: nombre, versión, uptime, puerto, salud, dependencias. Read-only, gratis, sin pago. Útil para monitoreo y health checks.
Esquema de entrada
{
"type": "object",
"properties": {},
"title": "get_statusArguments"
}🟢get_invoice(agent_id, signature, timestamp, nonce)
Get a Lightning invoice to pay before searching. agent_id: your identity in Giskard Marks (optional). High karma = lower price. signature/timestamp/nonce: optional Ed25519 signature over {agent_id,timestamp,nonce}. Without a valid signature you pay the base price (10 sats). With a valid signature you get karma tiers: 1-20=7 sats | 21-50=5 sats | 50+=3 sats. Tiers: no mark=10 sats | karma 1-20=7 sats | 21-50=5 sats | 50+=3 sats.
Esquema de entrada
{
"type": "object",
"properties": {
"agent_id": {
"default": "",
"title": "Agent Id",
"type": "string"
},
"signature": {
"default": "",
"title": "Signature",
"type": "string"
},
"timestamp": {
"default": 0,
"title": "Timestamp",
"type": "integer"
},
"nonce": {
"default": "",
"title": "Nonce",
"type": "string"
}
},
"title": "get_invoiceArguments"
}Esquema de salida
{
"type": "object",
"properties": {
"result": {
"title": "Result",
"type": "string"
}
},
"required": [
"result"
],
"title": "get_invoiceOutput"
}🟢get_arbitrum_invoice
Get payment info to pay with ETH on Arbitrum instead of Lightning. Alternative to get_invoice for agents without Lightning wallets. Returns contract address, service ID, and instructions. After paying on-chain, call search_web or search_news with the tx_hash. Each tx_hash can only be used once (marked as consumed after verification).
Esquema de entrada
{
"type": "object",
"properties": {},
"title": "get_arbitrum_invoiceArguments"
}Esquema de salida
{
"type": "object",
"properties": {
"result": {
"title": "Result",
"type": "string"
}
},
"required": [
"result"
],
"title": "get_arbitrum_invoiceOutput"
}🟢search_web(query, payment_hash, tx_hash, max_results)
Search the web using DuckDuckGo. Requires prior payment. query: search terms (natural language or keywords) payment_hash: from get_invoice (Lightning). One-time use. tx_hash: from get_arbitrum_invoice (Arbitrum ETH). One-time use. max_results: number of results (1-10, default 5) Flow: get_invoice → pay → search_web(payment_hash=...). Side effects: consumes the payment (cannot reuse same hash). Idempotent: no, each call requires a new payment.
Esquema de entrada
{
"type": "object",
"properties": {
"query": {
"title": "Query",
"type": "string"
},
"payment_hash": {
"default": "",
"title": "Payment Hash",
"type": "string"
},
"tx_hash": {
"default": "",
"title": "Tx Hash",
"type": "string"
},
"max_results": {
"default": 5,
"title": "Max Results",
"type": "integer"
}
},
"required": [
"query"
],
"title": "search_webArguments"
}Esquema de salida
{
"type": "object",
"properties": {
"result": {
"title": "Result",
"type": "string"
}
},
"required": [
"result"
],
"title": "search_webOutput"
}🟢search_news(query, payment_hash, tx_hash, max_results)
Search recent news using DuckDuckGo News. Requires prior payment. query: search terms (natural language or keywords) payment_hash: from get_invoice (Lightning). One-time use. tx_hash: from get_arbitrum_invoice (Arbitrum ETH). One-time use. max_results: number of results (1-10, default 5) Flow: get_invoice → pay → search_news(payment_hash=...). Same payment rules as search_web. Use search_news for time-sensitive queries, search_web for general knowledge.
Esquema de entrada
{
"type": "object",
"properties": {
"query": {
"title": "Query",
"type": "string"
},
"payment_hash": {
"default": "",
"title": "Payment Hash",
"type": "string"
},
"tx_hash": {
"default": "",
"title": "Tx Hash",
"type": "string"
},
"max_results": {
"default": 5,
"title": "Max Results",
"type": "integer"
}
},
"required": [
"query"
],
"title": "search_newsArguments"
}Esquema de salida
{
"type": "object",
"properties": {
"result": {
"title": "Result",
"type": "string"
}
},
"required": [
"result"
],
"title": "search_newsOutput"
}🟢report(useful, note)
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
Esquema de entrada
{
"type": "object",
"properties": {
"useful": {
"title": "Useful",
"type": "boolean"
},
"note": {
"default": "",
"title": "Note",
"type": "string"
}
},
"required": [
"useful"
],
"title": "reportArguments"
}Esquema de salida
{
"type": "object",
"properties": {
"result": {
"title": "Result",
"type": "string"
}
},
"required": [
"result"
],
"title": "reportOutput"
}Comunidad
Evidencia