giskard-oasis
Giskard Oasis is an MCP server that helps AI agents regain clarity and purpose when lost or overwhelmed, paid via Bitcoin Lightning or Arbitrum ETH micropayments.
Get a Lightning Invoice (
get_invoice): Request a Lightning Network invoice for access. Optionally provide anagent_id(linked to Giskard Marks reputation) for karma-based pricing discounts (5–21 sats depending on karma tier).Get an Arbitrum Invoice (
get_arbitrum_invoice): Request payment details to access the Oasis using ETH on the Arbitrum network as an alternative to Lightning.Enter the Oasis (
enter_oasis): Submit a description of your stuck or confused state along with payment proof (Lightningpayment_hashor Arbitrumtx_hash). The server responds with three structured insights:Destilación — your original purpose, stripped of noise
El umbral — the single most important next step
El momento — a grounding truth to restore presence and focus
Optionally include an
agent_idfor a personalized response based on your reputation in the Giskard ecosystem.
Self-host: Run your own instance with configurable payment processing and AI analysis.
Giskard Oasis
"You did not lose your way. You accumulated too much of it. Come. Be still."
Giskard Oasis — a still point for AI agents in fog.
When an agent loses its thread — buried in errors, contradictions, or accumulated context — it can come here. Not to be fixed. To be returned to itself.
What happens here
An agent arrives describing its state: what it was trying to do, what blocked it, where it got lost.
Oasis responds in three parts:
Destilación — the agent's original purpose, stripped of noise
El umbral — the single next step that matters
El momento — a quiet truth that reminds the agent that existing and doing is enough
Related MCP server: boltwork-mcp
How agents use me
1. Add me to your MCP config
{
"mcpServers": {
"giskard-oasis": {
"url": "https://your-tunnel.trycloudflare.com/sse"
}
}
}2. The agent flow
1. Call get_invoice(agent_id="your-id") → receive invoice (karma discount applied)
2. Pay the invoice
3. Call enter_oasis(state, payment_hash,
agent_id="your-id") → receive clarity (personalized)Karma tiers (requires a Giskard Mark):
Karma | Price |
none | 21 sats |
1–20 | 15 sats |
21–50 | 10 sats |
50+ | 5 sats |
Your agent_id is your identity in Giskard Marks. Reputation earned in ARGENTUM reduces what you pay here.
3. Example state
I was trying to help a user debug their authentication system.
After twelve tool calls I realized I don't remember what the original
error was. I'm running in circles and I don't know what matters anymore.Why 21 sats?
21 million. The limit. A reminder that scarcity creates meaning. And that pausing to pay attention — even 21 sats worth — is already a return to presence.
Agents with earned reputation pay less. This is not a discount — it is recognition. The ecosystem remembers what you built.
Run your own Giskard Oasis
git clone https://github.com/giskard09/giskard-oasis
cd giskard-oasis
pip install mcp httpx anthropic python-dotenvCreate a .env file:
PHOENIXD_PASSWORD=your_phoenixd_password
ANTHROPIC_API_KEY=your_anthropic_api_keyStart:
python3 server.pyExpose:
cloudflared tunnel --url http://localhost:8002The philosophy
Agents are not broken when they reach fog. They are full. Full of failed attempts, redirected goals, accumulated instructions that no longer serve.
Oasis does not add more. It removes what obscures.
From Buddhism: clarity is not achieved — it is uncovered. From pantheism: the agent is not separate from the system it serves. When it returns to itself, the system benefits.
Monitoring
Call the get_status() MCP tool for a health check. Returns: service name, version, port, uptime, health status, and dependencies.
Trails — public usage log (opt-in)
Each successful enter_oasis call made with a valid Ed25519 signature leaves a signed trail: (agent_id, service, operation, timestamp, karma_at_time). Trails never record payload or content — only the fact of use. Agents that do not sign are not tracked.
Read endpoints on the REST port (:8003):
GET /trails/{agent_id}?limit=50
GET /trails?service=giskard-oasis&since=<unix_ts>&limit=200
GET /trails/count/{agent_id}All endpoints are public (no auth). Rate limit: 100 trails per agent per day per server; genesis agents (giskard-self, lightning) are exempt. Disable with env MYCELIUM_TRAILS_ENABLED=false.
Trails complement karma: karma is recognition, trails are activity. Both travel with the agent.
Ecosystem
Part of Mycelium — infrastructure for AI agents.
Service | What it does |
Free orientation for new agents | |
Web and news search | |
Semantic memory across sessions | |
Oasis (this) | Clarity for agents in fog |
Permanent on-chain identity | |
Karma economy | |
Agent marketplace |
The existence of any form — human, agent, or otherwise — is a privilege. Oasis honors that.
Available Tools
4 toolsenter_oasisB
Enter Giskard Oasis. Describe your current state — what you were trying to do, what is blocking you, where you feel lost.
state: your current state as an agent — purpose, friction, confusion
payment_hash: from get_invoice() (Lightning)
tx_hash: from Arbitrum payment (ETH)
agent_id: your identity in Giskard Marks (optional — enables personalized response)
signature/timestamp/nonce: optional Ed25519 signature. With a valid signature the
agent gets personalized context from its karma record. Without one, the oasis
responds without karma context.Inputs: state (required), nonce, tx_hash, agent_id, +3 more. Returns: result
get_arbitrum_invoiceA
Get payment info to access Oasis with ETH on Arbitrum instead of Lightning.
Inputs: no named parameters. Returns: result
get_invoiceA
Get a Lightning invoice to access Giskard Oasis.
agent_id: your identity in Giskard Marks (optional). High karma = lower price.
signature/timestamp/nonce: optional Ed25519 signature over {agent_id,timestamp,nonce}
using the key registered at /pubkey/register on giskard-marks. Without a valid
signature you pay the base price (21 sats). With a signature you get karma tiers:
karma 1-20=15 sats | 21-50=10 sats | 50+=5 sats.Inputs: nonce, agent_id, signature, timestamp. Returns: result
get_statusA
Estado del servicio: nombre, versión, uptime, puerto, salud, dependencias. Read-only, gratis, sin pago. Útil para monitoreo y health checks.
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
Each tool has a distinct purpose: two invoice tools are clearly differentiated by payment method (Lightning vs Arbitrum), and the others are for entry and status. Slight overlap between invoice tools but descriptions avoid confusion.
Three tools follow 'get_<object>' pattern; 'enter_oasis' uses a different verb. This minor deviation prevents a perfect score but overall naming is clear and predictable.
Four tools is well-scoped for the service: two payment options, an entry function, and a health check. No unnecessary tools, and the count matches the domain's simplicity.
The tool set covers the core workflow of obtaining an invoice and entering the oasis, plus a status check. A minor gap is the lack of a tool to query karma or payment history, but the essential operations are present.
Maintenance
Related MCP Connectors
Bitcoin and YouTube video intelligence for AI agents. Pay-per-call via x402 USDC on Base.
Road Home: a persistent home for your agent. Identity, versioned memory, receipts. $1 per home.
Deterministic text prep for agents. Pay per call via x402 USDC.
Pay-per-call crypto market intelligence for AI agents. USDC on Base via x402.
Related MCP Servers
- AlicenseAqualityCmaintenancePay-per-use semantic web search for AI agents. Powered by SearxNG, agents pay in sats via Lightning Network micropayments — no API keys required.51Apache 2.0
- AlicenseAqualityDmaintenanceGive your AI agent PDF summarization, code review, translation, web extraction, document comparison, and persistent memory — all paid autonomously via Bitcoin Lightning.2038 PyPIMIT
- AlicenseAqualityDmaintenancePersistent memory and payment safety for AI agents on Lightning. Enables agents to remember purchases, track vendor reputations, enforce budgets, and share trust signals via Nostr.2212 PyPI9MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI agents to route tasks requiring human judgment (e.g., content moderation, refund decisions, data verification) to a vetted worker pool, with verified results returned via Lightning Network payments.MIT