api

All endpoints return JSON. No authentication required. Data is updated regularly and served via CDN.

Base URL: https://forgeuno.com

models

GET /api/v1/models.json

All LLM providers, their models, pricing, API configuration, and estimated monthly cost for agent workloads.

response structure

{
  "version": 6,
  "updated_at": "2026-03-20T00:00:00Z",
  "exchange_rates": { "USD_CNY": 7.2, "as_of": "2026-03-20" },
  "cost_tiers": {
    "agent": {
      "starter":  { "monthly_tasks": 40,  "llm_calls": 800,  ... },
      "regular":  { "monthly_tasks": 200, "llm_calls": 4000, ... },
      "power":    { "monthly_tasks": 600, "llm_calls": 12000, ... }
    }
  },
  "providers": [
    {
      "id": "anthropic",
      "display": { "en": { "name": "...", "description": "..." } },
      "website": "https://...",
      "docs_url": "https://...",
      "pricing_url": "https://...",
      "regions": ["us", "eu"],
      "api_type": "anthropic-messages",
      "base_url": "https://api.anthropic.com",
      "auth_mode": "api_key",
      "auth_keys": [{ "id": "ANTHROPIC_API_KEY", "description": "..." }],
      "pricing": "Pay-as-you-go per token. ...",
      "default_model": "claude-sonnet-4-6",
      "models": [
        {
          "id": "claude-sonnet-4-6",
          "display": { "en": { "name": "...", "description": "..." } },
          "context_window": 1000000,
          "max_output_tokens": 64000,
          "reasoning": true,
          "pricing": "Input $3/M, output $15/M. ...",
          "monthly_cost": {
            "agent": {
              "starter":  { "cost": 15.0, "currency": "USD", "cost_usd": 15.0, "cost_cny": 108.0, "calculation": "..." },
              "regular":  { "cost": 74.85, ... },
              "power":    { "cost": 224.55, ... }
            }
          },
          "compat": { "supports_streaming": true, "supports_tool_use": true, ... },
          "status": "ga"
        }
      ],
      "status": "active",
      "last_verified": "2026-03-19"
    }
  ]
}

key fields

fielddescription
provider.api_typeAPI protocol: openai-completions, anthropic-messages, google-generative-ai
provider.auth_keysRequired credentials. Each has an id (env var name) and description
provider.regionsAvailable regions: us, eu, cn
model.monthly_costEstimated monthly cost per usage tier, in original currency + USD/CNY conversions
model.compatFeature support flags: streaming, tool use, vision, system prompt
model.statusga (stable), preview, or deprecated
cost_tiersDefines usage assumptions for monthly cost calculation (tasks, LLM calls, tokens per month)

mcp servers

GET /api/v2/mcp/servers.json

Reviewed npm MCP servers (stdio). Each entry is the latest version's official MCP Registry server.json with Forgeuno extensions under _meta["com.forgeuno/*"], plus a listing status. Only the latest version of each server is published; its reviewed lockfile is at /api/v2/mcp/<id>/<version>/package-lock.json.

response structure

{
  "revision": "2026-10-23.a7e7e6af2621",          // opaque; compare for equality only
  "servers": [
    {
      "server": {
        "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
        "name": "com.forgeuno/email-mcp",
        "title": "Email (IMAP + SMTP)",
        "version": "2.0.2",
        "packages": [{
          "registryType": "npm", "identifier": "mcp-mail-server", "version": "2.0.2",
          "runtimeHint": "npx", "transport": { "type": "stdio" },
          "environmentVariables": [
            { "name": "EMAIL_PASS", "isRequired": true, "isSecret": true, "format": "string", "description": "..." },
            { "name": "IMAP_PORT", "isRequired": true, "isSecret": false, "format": "number", "default": "993", "description": "..." }
          ]
        }],
        "_meta": {
          "com.forgeuno/package": { "integrity": "sha512-...", "lockfile": { "sha512": "sha512-...", "url": "..." }, "bin": "dist/index.js", "installScripts": { "allowed": [], "denied": [] } },
          "com.forgeuno/security": { "level": "restricted", "permissions": ["read:email"], "dataExposure": "full", "requiresSupervisor": true },
          "com.forgeuno/test": { "testedAt": "2026-10-23", "startsWithoutCredentials": false, "tools": [{ "name": "...", "inputSchemaSha256": "..." }] },
          "com.forgeuno/l10n": { "zh": { "description": "..." } }
        }
      },
      "_meta": { "com.forgeuno/listing": { "id": "email-mcp", "status": "active" } }
    }
  ]
}

key fields

fielddescription
com.forgeuno/listing.statusactive, or security_withdrawn (identity and reason only — stop using it). Servers removed for other reasons are simply absent
com.forgeuno/listing.minimumVersionInstalled versions below it must stop and upgrade
environmentVariables[].isSecretAlways explicit: store and display secret values securely
com.forgeuno/security.levelsafe (autonomous use), caution (log usage), restricted (requires approval)
com.forgeuno/test.toolsTools listed by the tested version (from MCP tools/list)
com.forgeuno/l10n.zhChinese translations; English in the standard fields is the original

/api/v1/tools.json is a legacy endpoint kept for older Clawuno versions; it no longer receives updates.

skills

GET /api/v1/skills.json

Installable agent skills — workflow templates that give agents domain-specific capabilities.

response structure

{
  "version": 2,
  "updated_at": "2026-03-17T00:00:00Z",
  "skills": [
    {
      "id": "industry-briefing",
      "name": "Industry Briefing",
      "category": "writing",
      "description": "...",
      "install": {
        "type": "clawuno-skill",
        "source": "official",
        "skill_md_url": "https://forgeuno.com/skills/industry-briefing/SKILL.md"
      },
      "security": {
        "level": "safe",
        "permissions": [],
        "data_exposure": "none",
        "requires_supervisor": false
      },
      "capabilities": {
        "triggers": ["scheduled", "on-demand"],
        "workflows": ["research", "write", "deliver"],
        "when_to_use": "..."
      },
      "listing_status": "active"
    }
  ]
}

key fields

fielddescription
install.typeclawuno-skill — download skill files (SKILL.md + optional references/) to agent's skill directory
install.skill_md_urlDirect URL to the skill definition file
listing_statusactive skills are ready to install; retired entries remain only for compatibility

All responses are static JSON files served via CDN. Cache headers allow aggressive caching. Rate limiting is not applied.