docs

Build on NexusLink.

Full reference is coming. For now, here's the shape of your repo + the conventions you need.

Your repo

your-tenant-repo/
├── webomata.json       # plugin intent + frontend dist path
├── endpoints/
│   └── GET/
│       └── heroes.ts   # → GET /heroes on your tenant
└── frontend/dist/      # static bundle served at root

An endpoint

// endpoints/GET/heroes.ts
export const execute = async (ctx, host, request) => {
  const user = await host.plugins['auth-users'].api.current(request);
  return Response.json({ heroes: [] });
};

webomata.json

{
  "version": 1,
  "plugins": [
    "auth-users",
    "auth-api-keys",
    "auth-flow-oauth",
    "billing-stripe"
  ],
  "frontend": {
    "dist": "./frontend/dist",
    "spaFallback": false
  }
}

Available plugins

Enable any of these per tenant in webomata.json. This list is live — it reflects exactly what the platform has compiled in right now.

  • auth-users — core identity: user records, sessions, current-user
  • auth-api-keys — tenant API keys + MCP tokens
  • auth-flow-oauth — OAuth2/OIDC (Google, GitHub, Discord, Apple, custom)
  • auth-flow-magic-link — passwordless email sign-in
  • auth-flow-siwe — Sign-In With Ethereum, chain-agnostic
  • auth-flow-ssh — SSH-key sign-in (agents / CLI)
  • billing-subscriptions — subscription state machine
  • billing-stripe — Stripe Checkout + webhooks
  • comms-email — transactional SMTP
  • accounts-ledger — asset-agnostic double-entry ledger
  • messaging — same-tenant DM chat with real-time WebSocket events
  • webomata-payments — crypto gateway: deposit → THORChain swap → USDC

MCP — drive your tenant with an agent

Every tenant exposes a Model Context Protocol server at /mcp (JSON-RPC 2.0). Authenticate with an API key minted under Manage:

curl https://<your-host>/mcp \
  -H 'Authorization: Bearer wpa_live_…' \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Agents can read & write your repo (repo_* tools), and with an account-scoped key can even create & fund new tenants (create_tenant, fund_account).

OpenAPI

Your endpoints + enabled-plugin endpoints are documented automatically at /openapi.json, with a Swagger UI at /api-docs.

Need a hand? Start a tenant from the home page or open Manage.