x=hub

your toolset

    build deployment
    sign in

    Giskard Oasis

    mcpother
    io.github.giskard09/oasis · v0.1.0
    deploy just this

    Contextual guidance for AI agents in fog states. Claude-backed, Ed25519, Lightning payment.

    run it

    on your own machines, one way per deploy method
    generated from the record, not tested yet
    CHANGE_ME: built from the repository's Dockerfile, assuming it serves streamable HTTP at :8000/mcp. Nothing has run this yet; the worker replaces it with a tested recipe.
    # once, as root:
    docker build -t mcp-local/oasis:latest https://github.com/giskard09/giskard-oasis.git
    
    #!/usr/bin/env bash
    # oasis (io.github.giskard09/oasis), recipe docker (generated).
    # Generated by Hub for toolset "my-agent"; started by mcp-my-agent-oasis.service.
    set -euo pipefail
    export HOST=127.0.0.1 PORT=8101
    exec docker run --rm --name mcp-my-agent-oasis -p 127.0.0.1:${PORT}:8000 --env-file /etc/mcp/my-agent.env mcp-local/oasis:latest
    
    [Unit]
    Description=MCP server oasis (toolset my-agent), generated by Hub
    After=network-online.target docker.service
    Wants=network-online.target
    
    [Service]
    Type=simple
    User=mcp
    Group=mcp
    SupplementaryGroups=docker
    EnvironmentFile=/etc/mcp/my-agent.env
    Environment=HOME=/var/lib/mcp/oasis
    WorkingDirectory=/var/lib/mcp/oasis
    ExecStart=/opt/mcp/my-agent/bin/oasis.sh
    Restart=on-failure
    RestartSec=5
    NoNewPrivileges=true
    ProtectSystem=strict
    ProtectHome=true
    PrivateTmp=true
    ReadWritePaths=/var/lib/mcp/oasis
    
    [Install]
    WantedBy=multi-user.target
    
    generated from the record, not tested yet
    CHANGE_ME: built from the repository's Dockerfile, assuming it serves streamable HTTP at :8000/mcp. Nothing has run this yet; the worker replaces it with a tested recipe.
    docker build -t oasis https://github.com/giskard09/giskard-oasis.git
    docker run --rm -p 127.0.0.1:8101:8000 oasis
    
    generated from the record, not tested yet
    CHANGE_ME: built from the repository's Dockerfile, assuming it serves streamable HTTP at :8000/mcp. Nothing has run this yet; the worker replaces it with a tested recipe.
    # Generated by Hub for toolset "my-agent" (2026-10-17T23:47:05+00:00).
    # Each package server runs behind a stdio->HTTP bridge and listens on localhost only.
    #   cp .env.example .env    # fill the ${VAR}s
    #   docker compose up -d && bash smoke.sh
    # Remote servers are not here: clients reach them directly (see clients/).
    name: mcp-my-agent
    services:
      oasis:
        build:
          context: https://github.com/giskard09/giskard-oasis.git
        ports:
        - 127.0.0.1:8101:8000
        restart: unless-stopped
        x-note: 'CHANGE_ME: built from the repository''s Dockerfile, assuming it serves streamable HTTP at
          :8000/mcp. Nothing has run this yet; the worker replaces it with a tested recipe.'
    volumes:
      npm-cache: {}
      uv-cache: {}
    
    generated from the record, not tested yet
    CHANGE_ME: built from the repository's Dockerfile, assuming it serves streamable HTTP at :8000/mcp. Nothing has run this yet; the worker replaces it with a tested recipe.
    # Generated by Hub for toolset "my-agent" (2026-10-17T23:47:05+00:00).
    #   kubectl create namespace mcp
    #   kubectl -n mcp create secret generic mcp-credentials --from-env-file=.env
    #   kubectl apply -f kubernetes.yaml
    # Services are cluster-internal: <name>.mcp.svc.cluster.local:8000/mcp. Put an ingress
    # with auth in front before exposing any of them.
    apiVersion: v1
    kind: Namespace
    metadata:
      name: mcp
    ---
    apiVersion: apps/v1
    kind: Deployment
    metadata:
      name: oasis
      namespace: mcp
      labels: &id001
        app: oasis
    spec:
      replicas: 1
      selector:
        matchLabels: *id001
      template:
        metadata:
          labels: *id001
        spec:
          containers:
          - name: oasis
            image: CHANGE_ME
            ports:
            - containerPort: 8000
              name: http
            env: []
    ---
    apiVersion: v1
    kind: Service
    metadata:
      name: oasis
      namespace: mcp
    spec:
      selector:
        app: oasis
      ports:
      - port: 8000
        targetPort: http
        name: http
    
    generated from the record, not tested yet
    CHANGE_ME: built from the repository's Dockerfile, assuming it serves streamable HTTP at :8000/mcp. Nothing has run this yet; the worker replaces it with a tested recipe.
    # Generated by Hub for toolset "my-agent" (2026-10-17T23:47:05+00:00).
    # Credentials come from the Secret 'mcp-credentials' (kubectl create secret generic ... --from-env-file=.env).
    # Each server under `servers` is one Deployment + Service; the keys after it configure
    # upstream charts a worker verified.
    servers:
      oasis:
        enabled: true
        replicas: 1
        port: 8000
        path: /mcp
        container:
          name: oasis
          image: CHANGE_ME
          ports:
          - containerPort: 8000
            name: http
          env: []
    
    # helm install my-agent helm/my-agent -n mcp
    

    in the cloud

    one click: the provider's deploy form opens filled in, in your own account
    koyeb

    Koyeb builds the repository's Dockerfile from branch main; change the branch in the form if the default one has another name.

    Clients connect to the service's https://…koyeb.app address plus /mcp.

    cloud run

    Cloud Shell clones the repository, builds its Dockerfile and deploys it to Cloud Run.

    Cloud Run sends requests to $PORT (8080); the recipe expects :8000, so the server has to read PORT, or set the container port on the service afterwards.

    connect to it

    copy what your client needs
    {
      "mcpServers": {
        "oasis": {
          "command": "CHANGE_ME",
          "args": []
        }
      }
    }
    #!/usr/bin/env bash
    # Registers every server with Claude Code (run once; `claude mcp list` to check).
    set -euo pipefail
    set -a; [ -f .env ] && source .env; set +a
    claude mcp add oasis -- CHANGE_ME
    
    {
      "mcpServers": {
        "oasis": {
          "command": "CHANGE_ME",
          "args": []
        }
      }
    }
    {
      "servers": {
        "oasis": {
          "type": "stdio",
          "command": "CHANGE_ME",
          "args": []
        }
      }
    }
    name: my-agent
    target: local
    servers:
    - hub: io.github.giskard09/oasis
    
    • no recipe for target 'local': fill the files by hand

    tools · 4

    • enter_oasisEnter 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.

      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.

      pin 28490605e442be463993f321882d165495e7a64815858c56981f2125965b76e1
    • get_arbitrum_invoiceGet payment info to access Oasis with ETH on Arbitrum instead of Lightning.

      Get payment info to access Oasis with ETH on Arbitrum instead of Lightning.

      pin 258d1d011e086de0b213fc48c4238a0cd51dbe019086a2c7cac2b4d11b0e0ceb
    • get_invoiceGet 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.

      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.

      pin dc8b6104fb5b3600faacf4ceb5df439b6420e5a849b6629bae840ec3db240447
    • get_statusEstado del servicio: nombre, versión, uptime, puerto, salud, dependencias. Read-only, gratis, sin pago. Útil para monitoreo y health checks.

      Estado del servicio: nombre, versión, uptime, puerto, salud, dependencias. Read-only, gratis, sin pago. Útil para monitoreo y health checks.

      pin 9fec6f07efa5875c3d1c617817900d9b40a7fec2722881b5659a4dc21b1d3df6

    runs · 1

    the latest tests of this entry by the hub and its workers, newest first
    dateworkermethodstatussandboxreason
    2026-10-16 09:49 local-mac remotemcp 2025-11-25 ok4 tools none —