Skip to main content
Glama
giskard-search
by giskard09

Glama AAA CI License

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


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=...)     → 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: 0xe40E376cD32b03E3084F9E0d646155D0Ba0A63ae

  • x402 wallet: 0xdcc84e9798e8eb1b1b48a31b8f35e5aa7b83dbf4


Stack


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.

Available Tools

5 tools
get_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

    A3.7/5.0

    Scored across 5 tools

    Disambiguation5/5

    Each tool serves a clearly distinct purpose: payment via two methods, two search scopes, and feedback. No overlap or ambiguity.

    Naming Consistency5/5

    All tools use snake_case and follow a consistent verb_noun pattern (e.g., get_invoice, search_web). The naming is predictable and uniform.

    Tool Count5/5

    With 5 tools, the set is well-scoped for a paid search service. It covers essential actions without being over- or under-engineered.

    Completeness4/5

    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

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      A 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.
      2
      13
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Pay-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.
      1
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables web search for AI agents with pay-per-search in USDC, no API keys needed.
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Provides a pay-per-query web search tool for AI agents via Lightning Network sats, enabling no-KYC, account-free searches through the MCP protocol.
      2
      54 npm
      MIT