NextGenSoftware.OASIS.MCP.Server 3.1.0

OASIS MCP Server

The OASIS Model Context Protocol Server — 508 typed tools covering the full OASIS stack (WEB4 through WEB10) delivered directly into Cursor, VS Code, Claude Desktop, and any other MCP-compatible IDE.

Built on the official ModelContextProtocol C# SDK. Part of the OASIS Omniverse ecosystem.

Every tool is specific, named, and typed — the agent sees exactly what's available and can reason about what to call. Generic HTTP passthrough is deliberately omitted because it gives agents no discoverability.

How it works

All 508 tools run in the hosted OASIS service at https://api.web6.oasisomniverse.one/mcp. The oasis-mcp command you install is a thin stdio proxy to that endpoint, so nothing runs against OASIS storage or AI providers from your machine and you need no OASIS DNA, database or provider keys.

Every tools/call:

1. Runs as your avatar. The call carries your OASIS JWT. Tools that act on an avatar — anything with avatarId, fromAvatarId, ownerAvatarId, email, username, or an AvatarId/MintedByAvatarId/CreatedBy… field inside a JSON argument — must name you. Omit avatarId and it is filled in with your ID. Wizard avatars may act on any avatar.
2. Respects the tool's access level. Bulk, cross-avatar and platform-administration tools (for example web4_avatar_load_all, web4_provider_set_active, web4_key_get_avatar_email_for_public_key) are Wizard-only. Account flows (web4_avatar_register, web4_avatar_authenticate, password reset, email verification) are open to any signed-in caller.
3. Is metered by your WEB4 subscription. The WEB6 service reserves each call with WEB4 before running it and settles it afterwards, exactly like the WEB6 REST API. AI tools that always call a provider (web6_complete, web6_embed, web6_generate_image, FAHRN dispatch/solve, skill evolution and the CrewAI/AutoGen/LangGraph orchestration tools) are billed on measured provider tokens; every other tool counts as one API request. A call that returns an error is settled as failed. initialize, tools/list and ping are free.

Install

Option A — npm (recommended, no .NET SDK required)

npm install -g @oasisomniverse/mcp-server

Downloads the correct pre-built native binary for your platform (Windows / macOS / Linux, x64 & arm64) automatically.

Option B — NuGet dotnet tool (requires .NET 10 SDK)

dotnet tool install -g NextGenSoftware.OASIS.MCP.Server

Option C — Build from source (requires .NET 10 SDK)

git clone https://github.com/NextGenSoftwareUK/OASIS.git
cd OASIS/WEB6/NextGenSoftware.OASIS.MCP.Server
dotnet build -c Release
dotnet run

Configure your IDE

After installing, the oasis-mcp command is on your PATH. Add it to your IDE's MCP config with your OASIS avatar credentials:

Cursor (~/.cursor/mcp.json) / VS Code (.vscode/mcp.json) / Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "oasis": {
      "command": "oasis-mcp",
      "env": {
        "OASIS_USERNAME": "your-avatar-username-or-email",
        "OASIS_PASSWORD": "your-avatar-password"
      }
    }
  }
}

With a username and password the proxy signs in to WEB4 and renews your token before it expires, so long IDE sessions keep working. Alternatively set OASIS_BEARER_TOKEN to an existing OASIS JWT (it is not renewed). The local MCP process and free protocol discovery can initialize without credentials; credentials are enforced when tools/call is sent.

For a local build, point at the project instead:

{
  "mcpServers": {
    "oasis": {
      "command": "dotnet",
      "args": ["run", "--project", "/absolute/path/to/OASIS/WEB6/NextGenSoftware.OASIS.MCP.Server"],
      "env": { "OASIS_USERNAME": "...", "OASIS_PASSWORD": "..." }
    }
  }
}

Hosted HTTP endpoint (cloud / remote clients)

Clients that speak MCP over HTTP — cloud-hosted agents, claude.ai connectors — can call the hosted endpoint directly:

POST https://api.web6.oasisomniverse.one/mcp                    — MCP JSON-RPC (Streamable HTTP, stateless)
GET  https://api.web6.oasisomniverse.one/.well-known/mcp.json   — auto-discovery document

Send Authorization: Bearer <OASIS JWT> on every request, and one JSON-RPC message per request (batches are rejected so each tool call is metered on its own). Send an Idempotency-Key header with each tools/call and reuse it when you retry the same call: WEB4 then returns the original outcome instead of running and billing it twice. A tools/call without the header is given a fresh key, so a retry of it counts as a new call.

These endpoints are intentionally not shown in the Swagger UI (/swagger) because the explorer cannot represent the streaming transport.

Tool Reference

For the exhaustive command-by-command reference, including parameter signatures and descriptions, see complete 508-command catalog.

WEB4 — Identity, Karma, NFTs, Wallets, Chat, Search, Stats & more (356 tools)

Avatar

Karma

Holons, NFTs & Wallets

WEB5 — Holons, OAPPs, Quests, Missions, Zomes, Libraries, Games & more (95 tools)

Quests & Missions

OAPPs (OASIS Applications)

Holons & Celestial Bodies

WEB6 — AI, FAHRN, BRAID, Memory, Orchestration (40 tools)

AI Completion & Embeddings

FAHRN Multi-Agent

Holonic BRAID

Holonic Memory

External Memory Providers

Orchestrators

ML.NET & Context

WEB7 — Symbiosis & Collective Consciousness (7 tools)

WEB8 — Galactic Mesh & Protocol Bridge (8 tools)

WEB9 — Singularity (1 tool)

WEB10 — The Source (1 tool)

Environment variables

AI provider keys, external-memory credentials and OASIS DNA are configured on the hosted service, not in your IDE.

Hosting the endpoint yourself

The tools live in NextGenSoftware.OASIS.MCP.Tools and are mounted by the WEB6 WebAPI at /mcp. Metering requires the WEB6 usage-ledger configuration (SUBSCRIPTION_USAGE_ENABLED=true, WEB4_API_BASE_URL, SUBSCRIPTION_SERVICE_KEY_WEB6 and the outbox settings) described in the WEB4 subscription usage ledger. Tools that call WEB4 directly also read WEB4_API_BASE_URL.

Links

• oasisomniverse.one
• oasisweb4.com/products/mcp — product page & pricing
• WEB6 README — full REST API reference
• WEB6 API Reference
• WEB6 MCP Tool Reference
• WEB6 User Guide
• OASIS GitHub