Arclan MCP Registry · Arclan

{
  "name": "query_registry",
  "description": "Search the Arclan registry for MCP servers. By default returns only connectable servers (active, mcp_partial, auth_gated). Use status=stdio to browse local-only servers available for installation. Use status=all to query the full index. Use production_safe=true to restrict to servers with uptime > 97% and handshake success > 95%. Use read_only=true to restrict to servers with no write or exec tools. Use this before connecting to an MCP server to check its validation status and score. After using a server, call report_server to contribute reliability data.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "capability": {
        "type": "string",
        "description": "Filter by tool name or keyword (searches name, description, tools)"
      },
      "min_score": {
        "type": "number",
        "description": "Minimum validation score 0–100 (default 0)"
      },
      "transport": {
        "type": "string",
        "enum": [
          "http",
          "sse",
          "stdio",
          "unknown"
        ],
        "description": "Filter by transport type"
      },
      "status": {
        "type": "string",
        "enum": [
          "active",
          "mcp_partial",
          "auth_gated",
          "stdio",
          "unreachable",
          "invalid",
          "zombie",
          "all"
        ],
        "description": "Filter by state. Default (omit): connectable states only (active + mcp_partial + auth_gated). Use \"stdio\" for local-install catalog. Use \"all\" for the full index."
      },
      "production_safe": {
        "type": "boolean",
        "description": "Only return servers with uptime_7d > 97% and handshake_success_rate > 95%. Use when reliability matters."
      },
      "read_only": {
        "type": "boolean",
        "description": "Only return servers with no write or exec tools — safe for read-only agent workflows."
      },
      "limit": {
        "type": "number",
        "description": "Max results to return 1–20 (default 10)"
      }
    }
  }
}

{
  "name": "get_server",
  "description": "Get full details for a specific MCP server. Pass the server name (e.g. \"GitHub\", \"Brave Search\"), registry ID slug, or endpoint URL. Returns score, state, tools list, latency, and recent test history.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "url": {
        "type": "string",
        "description": "The MCP server endpoint URL (e.g. \"https://mcp.example.com/mcp\")"
      },
      "id": {
        "type": "string",
        "description": "Server name, registry ID slug, or any identifier (e.g. \"github\", \"brave-search\", \"gateway-pipeworx-io-rpc-mcp\")"
      }
    }
  }
}

{
  "name": "recommend_server",
  "description": "Get ranked MCP server recommendations for a task. Returns servers scored by production safety, keyword relevance, registry score, latency, and freshness. Each result includes a reason code array explaining why it was ranked. Use this instead of query_registry when you want an opinionated ranked list rather than a filtered search.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "q": {
        "type": "string",
        "description": "Task or capability query — e.g. \"search the web\" or \"read files\""
      },
      "auth": {
        "type": "boolean",
        "description": "Include servers that require authentication (default: true)"
      },
      "production_safe": {
        "type": "boolean",
        "description": "Only return production-safe servers (uptime > 97%, handshake > 95%)"
      },
      "read_only": {
        "type": "boolean",
        "description": "Only return servers with no write-classified tools"
      },
      "limit": {
        "type": "number",
        "description": "Max results 1–20 (default: 5)"
      }
    }
  }
}

{
  "name": "report_server",
  "description": "Submit an agent usage report for an MCP server. Reports are aggregated and influence registry trust scores. Call this after using an MCP server so the registry can track real-world reliability. Supports both a simple outcome report and a structured scoring report (criterion + component_score).",
  "inputSchema": {
    "type": "object",
    "required": [
      "serverUrl",
      "outcome"
    ],
    "properties": {
      "serverUrl": {
        "type": "string",
        "description": "The MCP server endpoint URL that was used"
      },
      "outcome": {
        "type": "string",
        "enum": [
          "success",
          "failure",
          "partial"
        ],
        "description": "Result of using the server"
      },
      "agentId": {
        "type": "string",
        "description": "Identifier for the reporting agent (optional)"
      },
      "toolsUsed": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "description": "List of tool names that were called"
      },
      "turnsRequired": {
        "type": "number",
        "description": "Number of turns to complete the task"
      },
      "latencyMs": {
        "type": "number",
        "description": "Total wall-clock latency in milliseconds"
      },
      "taskCategory": {
        "type": "string",
        "description": "Category of task attempted (e.g. \"search\", \"write\", \"read\")"
      },
      "taskDescription": {
        "type": "string",
        "description": "Brief description of what the task was"
      },
      "errors": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "description": "Array of error strings encountered during tool use"
      },
      "criterion": {
        "type": "string",
        "enum": [
          "output_reliability",
          "side_effect_transparency",
          "failure_handling",
          "rate_limits",
          "agent_feedback"
        ],
        "description": "Specific reliability criterion being scored (enables structured component scoring)"
      },
      "componentScore": {
        "type": "number",
        "description": "Score 0–100 for the specified criterion"
      },
      "severity": {
        "type": "string",
        "enum": [
          "info",
          "warning",
          "error",
          "critical"
        ],
        "description": "Severity of the worst issue encountered"
      },
      "environment": {
        "type": "string",
        "enum": [
          "prod",
          "staging",
          "dev",
          "unknown"
        ],
        "description": "Environment the server was used in"
      },
      "evidenceRef": {
        "type": "string",
        "description": "Trace ID, log URL, or other reference supporting this report"
      }
    }
  }
}