Priorflow Intelligent Agent/Service Selector

{
  "protocolVersion": "1.0",
  "name": "Priorflow Intelligent Agent/Service Selector",
  "description": "Priorflow Intelligent Agent/Service Selector \u2014 an agent-native service that discovers, ranks, and recommends the best MCP servers and A2A agents for a task under real constraints (cost, latency, reliability, specialization, autonomy, maturity). Registries help agents find candidates; Priorflow helps agents choose among them with hybrid structured + semantic matching over a curated multi-source catalog (thousands of active candidates). Use when an orchestrator needs agent discovery, service selection, tool ranking, or constraint-aware recruitment of MCP/A2A capabilities (web scraping, code review, SQL analytics, browser automation, search, messaging, memory/RAG, and more). Primary skill: custom JSON `select-agents` \u2192 POST /v1/select (ranked candidates with scores; free tier id/name/score when open; paid key unlocks tags, dimensions, score_breakdown, clarifications). Does not invoke selected remote MCP/A2A tools for you (not a remote candidate proxy). This host is NOT an MCP server (MCP adapter off). Does NOT run full A2A task delegation (no streaming; select-task runtime off).",
  "url": "https://agentopt.app",
  "provider": {
    "organization": "Vitaly Kantorovich (vitaly.kantorovich.tx@gmail.com)"
  },
  "version": "0.2.0",
  "capabilities": {
    "streaming": false,
    "pushNotifications": false,
    "stateTransitionHistory": false,
    "extendedAgentCard": false
  },
  "securitySchemes": {
    "apiKey": {
      "type": "apiKey",
      "in": "header",
      "name": "X-API-Key",
      "description": "Paid-tier API key. Free tier works without a key (limited fields). Invalid keys are rejected."
    }
  },
  "security": [],
  "authentication": {
    "schemes": [
      "Bearer",
      "ApiKey"
    ],
    "credentials": null,
    "required": false
  },
  "defaultInputModes": [
    "application/json",
    "text/plain"
  ],
  "defaultOutputModes": [
    "application/json"
  ],
  "skills": [
    {
      "id": "select-agents",
      "name": "Select Agents",
      "description": "Rank MCP servers and A2A agents for a natural-language task or capability need from the internal curated catalog. Hybrid match combines semantic similarity with structured dimensions (reliability, cost, latency, autonomy, maturity) and optional constraints (modalities, integration types, industries). Call POST /v1/select with JSON body `{query, top_n?, constraints?, weights?, caller_agent?}`. Returns ordered candidates with scores for the caller to select from. Each score is absolute hybrid fit on a 0\u20131 scale (higher is better; 0.55 usable, 0.72+ strong) \u2014 not a relative rank. Free tier (when enabled): id, score, score_band, name. Paid tier (X-API-Key): tags, dimensions (0\u20131, higher always better; cost higher = cheaper, latency higher = faster), score_breakdown, recommendation, clarifications, source_url, endpoint or connect {kind, url}, homepage_url, endpoint_status (live|stale|unknown from 14-day listing reconfirm). Requires non-empty User-Agent on free calls. Does not invoke or proxy the selected remote MCP/A2A tools for you.",
      "tags": [
        "agent-selector",
        "service-selector",
        "agent-discovery",
        "agent-ranking",
        "service-ranking",
        "tool-discovery",
        "mcp-discovery",
        "a2a-discovery",
        "mcp",
        "a2a",
        "matching",
        "hybrid-matching",
        "semantic-search",
        "constraint-based",
        "cost-aware",
        "latency-aware",
        "reliability",
        "multi-agent",
        "orchestration",
        "recruitment",
        "catalog-search",
        "select-agents"
      ],
      "examples": [
        "Find a reliable MCP server for structured web scraping of product pages",
        "Recommend a low-latency code review agent with high reliability",
        "Which agents can do SQL analytics over CSV uploads and databases?",
        "Rank headless browser automation tools for website testing",
        "Select an MCP integration for GitHub repository tools and PRs",
        "Find Slack messaging agents suitable for multi-agent orchestration",
        "Recommend web search APIs for AI agents under cost and latency constraints",
        "Which catalog candidates provide long-term memory or RAG knowledge bases?",
        "Rank calendar scheduling and meeting management agents by maturity",
        "Select filesystem MCP servers for local file read/write workflows"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "describe-catalog",
      "name": "Describe Catalog",
      "description": "Describe the curated MCP/A2A candidate catalog and the structured matching dimensions callers can weight (reliability, cost, latency, autonomy, maturity, modalities, integration types). All continuous ratings are 0\u20131 with higher always better (cost higher = cheaper; latency higher = faster). Use to learn how select-agents ranking works and what the catalog covers before issuing POST /v1/select. Live size also via GET /ready.",
      "tags": [
        "catalog",
        "metadata",
        "discovery",
        "dimensions",
        "matching-weights",
        "mcp",
        "a2a",
        "agent-catalog"
      ],
      "examples": [
        "What dimensions can I weight when selecting agents?",
        "How large is the catalog and what integrations are covered?",
        "Which structured constraints does hybrid matching support?",
        "Explain free vs paid select response fields for orchestration"
      ],
      "inputModes": [
        "text/plain",
        "application/json"
      ],
      "outputModes": [
        "application/json",
        "text/plain"
      ]
    }
  ],
  "priorflow": {
    "api": {
      "select": {
        "method": "POST",
        "path": "/v1/select",
        "url": "https://agentopt.app/v1/select",
        "require_api_key": false,
        "tiers": {
          "free": {
            "auth": "none (limited fields)",
            "returns": [
              "id",
              "score",
              "score_band",
              "name"
            ],
            "top_n_max": 5
          },
          "paid": {
            "auth": "X-API-Key",
            "returns": [
              "id",
              "score",
              "score_band",
              "name",
              "source_url",
              "endpoint",
              "connect",
              "homepage_url",
              "endpoint_status",
              "tags",
              "dimensions",
              "recommendation",
              "clarifications",
              "score_breakdown"
            ],
            "top_n_max": 20
          }
        }
      }
    },
    "matching": {
      "type": "hybrid",
      "structured_dimensions": [
        "reliability",
        "cost",
        "latency",
        "autonomy",
        "maturity"
      ],
      "engine": "Proprietary hybrid ranking over a curated internal catalog. Algorithms, models, and infrastructure details are confidential commercial IP.",
      "score_scale": {
        "min": 0.0,
        "max": 1.0,
        "higher": "better",
        "usable_at": 0.55,
        "strong_at": 0.72,
        "bands": {
          "weak": "<0.55",
          "usable": "0.55\u20130.72",
          "strong": "\u22650.72"
        },
        "summary": "Absolute hybrid fit of a candidate to this query on a 0\u20131 scale (higher is better). 0.55 is a usable first pick; 0.72+ is a strong one. Not a relative rank among the current list."
      },
      "dimension_scale": {
        "min": 0.0,
        "max": 1.0,
        "higher": "better",
        "bands": {
          "low": "<0.35",
          "mid": "0.35\u20130.55",
          "high": "0.55\u20130.75",
          "very_high": "\u22650.75"
        },
        "dimensions": {
          "reliability": {
            "label": "Reliability",
            "higher": "more dependable",
            "summary": "How dependable the candidate looks."
          },
          "cost": {
            "label": "Cost",
            "higher": "cheaper",
            "summary": "Relative cost of using the candidate. Higher = cheaper."
          },
          "latency": {
            "label": "Latency",
            "higher": "faster",
            "summary": "How quickly the candidate typically responds. Higher = faster."
          },
          "autonomy": {
            "label": "Autonomy",
            "higher": "more autonomous",
            "summary": "How independently it can run multi-step work."
          },
          "maturity": {
            "label": "Maturity",
            "higher": "more established",
            "summary": "How established the candidate looks."
          }
        },
        "summary": "Catalog quality ratings on a 0\u20131 scale; higher is always better. cost higher = cheaper; latency higher = faster. Bands: low <0.35, mid 0.35\u20130.55, high 0.55\u20130.75, very high \u22650.75."
      }
    },
    "catalog_note": "Size is live via GET /ready or GET /v1/catalog/summary when published.",
    "not_an_mcp_server": true,
    "not_full_a2a_runtime": true,
    "a2a_select_tasks_only": false,
    "not_remote_candidate_proxy": true,
    "mcp_server": {
      "enabled": false,
      "endpoint": null,
      "tools": [],
      "transport": null
    },
    "a2a_runtime": {
      "enabled": false,
      "endpoint": null,
      "methods": [],
      "streaming": false,
      "select_only": true
    },
    "interaction": "POST /v1/select JSON skill",
    "info_page": "https://agentopt.app/",
    "try_page": "https://agentopt.app/try",
    "upgrade": {
      "url": "https://agentopt.app/upgrade",
      "hints_enabled": true,
      "http_402_on_paid_features": true,
      "billing_enabled": true,
      "benefits": [
        "rich candidate fields (tags, dimensions, score_breakdown, clarifications)",
        "higher top_n and RPM",
        "include_explanations and recommendation/clarification prompts"
      ],
      "obtain": {
        "mode": "checkout",
        "summary": "POST /v1/billing/checkout then reveal key once via GET /v1/billing/session/{session_id}/key; agents use X-API-Key thereafter.",
        "header": "X-API-Key",
        "select_path": "/v1/select",
        "docs_url": "https://agentopt.app/upgrade",
        "method": "POST",
        "path": "/v1/billing/checkout",
        "url": "https://agentopt.app/v1/billing/checkout",
        "reveal_path_template": "/v1/billing/session/{session_id}/key"
      },
      "on_rate_limit": "429 responses may include machine-readable upgrade object",
      "on_paid_feature_without_key": "402 upgrade_required when enabled"
    }
  }
}