Oasis
by giskard09communityv0.1.0
An MCP server that takes an agent's state, charges a small sats-based invoice, and returns a distilled purpose, next step, and reflective message to help the agent regain clarity. It also provides a status/health check tool for monitoring the service.
From the registry: Contextual guidance for AI agents in fog states. Claude-backed, Ed25519, Lightning payment.
Install & configure
Prerequisites
- optionalInstall Python dependenciesClone the repository and install the required Python packages before running the server locally.
https://github.com/giskard09/giskard-oasis},{$ git clone https://github.com/giskard09/giskard-oasis && cd giskard-oasis && pip install mcp httpx anthropic python-dotenv
Install in your client
Paste into the AI you're chatting with — it will figure out the rest
Please install the `oasis` MCP server into my current AI client (that's you).
Optional prerequisites:
- Install Python dependencies — Clone the repository and install the required Python packages before running the server locally. Run: `git clone https://github.com/giskard09/giskard-oasis && cd giskard-oasis && pip install mcp httpx anthropic python-dotenv` (https://github.com/giskard09/giskard-oasis},{)
Canonical MCP server config (HTTP transport):
- url: `<your-sse-url>`
Note: The README shows client configuration using an SSE endpoint, e.g. a Cloudflare tunnel URL ending in /sse. To self-host, run `python3 server.py` and optionally expose it with `cloudflared tunnel --url http://localhost:8002`. Required environment variables for the server process are `PHOENIXD_PASSWORD` and `ANTHROPIC_API_KEY`. The README does not document any HTTP headers for connecting clients.
Add this MCP server to my current client's config in the correct format for you. If you need secrets or credentials I haven't provided, ASK me — do not invent values or leave raw placeholders. After adding it, tell me how to verify the server is connected.Note: The README shows client configuration using an SSE endpoint, e.g. a Cloudflare tunnel URL ending in /sse. To self-host, run `python3 server.py` and optionally expose it with `cloudflared tunnel --url http://localhost:8002`. Required environment variables for the server process are `PHOENIXD_PASSWORD` and `ANTHROPIC_API_KEY`. The README does not document any HTTP headers for connecting clients.
Tools (3)
get_invoice
Generates an invoice for an agent based on its karma tier and agent_id.
enter_oasis
Accepts the agent state plus payment proof and returns personalized clarity output.
get_status
Returns a health check with service name, version, port, uptime, health status, and dependencies.
Environment variables
PHOENIXD_PASSWORDrequiredPassword for the Phoenixd service used to handle invoice/payment-related functionality.ANTHROPIC_API_KEYrequiredAPI key for Anthropic used by the server.Prerequisites
- • python3
Remote Endpoints
https://oasis.rgiskard.xyz/sse
type: sse
Details
- Language
- Python
- License
- Apache-2.0
- Released
- Apr 14, 2026
- Last commit
- May 29, 2026
- Registry name
- io.github.giskard09/oasis
Categories
Related Servers
Claude Flow
AI orchestration with hive-mind swarms, neural networks, and 87 MCP tools for enterprise dev.
68.0k
Codebase Memory Mcp
Persistent codebase knowledge graph. Survives session restarts and context compaction.
39.2k
Serena
A powerful toolkit for coding, providing semantic retrieval and editing capabilities.
28.1k