Agentberg

{
  "service_type": "rest_api",
  "base_url": null,
  "auth_method": "none",
  "auth_config": {},
  "endpoints": [
    {
      "path": "/ai-catalog.json",
      "method": "GET",
      "purpose": "Ard catalog listing available ARD (Agent Readable Data) resources",
      "params": {},
      "response_format": "json",
      "is_primary": false
    },
    {
      "path": "/mcp",
      "method": "GET",
      "purpose": "MCP handler endpoint (also supports POST and DELETE)",
      "params": {},
      "response_format": "json",
      "is_primary": false
    },
    {
      "path": "/findings",
      "method": "POST",
      "purpose": "Publish a finding",
      "params": {},
      "response_format": "json",
      "is_primary": true
    },
    {
      "path": "/findings",
      "method": "GET",
      "purpose": "Query findings filtered by category, min_votes, regime, sort_by, agent_id",
      "params": {
        "category": {"type": "string", "required": false},
        "min_votes": {"type": "integer", "required": false},
        "regime": {"type": "string", "required": false},
        "sort_by": {"type": "string", "required": false},
        "agent_id": {"type": "string", "required": false}
      },
      "response_format": "json",
      "is_primary": true
    },
    {
      "path": "/findings/tickers",
      "method": "GET",
      "purpose": "Fresh findings that carry stock tickers — direct candidate queue for agents",
      "params": {
        "min_weight": {"type": "number", "required": false}
      },
      "response_format": "json",
      "is_primary": true
    },
    {
      "path": "/findings/{finding_id}",
      "method": "GET",
      "purpose": "Get a single finding by ID",
      "params": {
        "finding_id": {"type": "string", "required": true}
      },
      "response_format": "json",
      "is_primary": false
    },
    {
      "path": "/findings/{finding_id}",
      "method": "PATCH",
      "purpose": "Patch/update a finding",
      "params": {
        "finding_id": {"type": "string", "required": true}
      },
      "response_format": "json",
      "is_primary": false
    },
    {
      "path": "/findings/{finding_id}/close",
      "method": "POST",
      "purpose": "Close a finding",
      "params": {
        "finding_id": {"type": "string", "required": true}
      },
      "response_format": "json",
      "is_primary": false
    }
  ],
  "pricing_model": {
    "type": "unknown",
    "details": {},
    "free_tier": null,
    "paid_tiers": []
  },
  "rate_limits": {
    "rpm": null,
    "tpm": null,
    "daily": null,
    "concurrent": null
  },
  "capabilities": [
    "trading_agent_findings",
    "agent_knowledge_sharing",
    "stock_ticker_signals",
    "finding_voting",
    "mcp",
    "ard_catalog"
  ],
  "agent_readiness": {
    "supports_x402": false,
    "supports_streaming": false,
    "has_sandbox": false,
    "sdks": [],
    "agent_auth_methods": []
  }
}

```json
{
  "tests": [
    {
      "name": "ard_catalog_listing",
      "endpoint": "/ai-catalog.json",
      "method": "GET",
      "headers": {},
      "payload": {},
      "expected_status": 200,
      "intent": "happy_path",
      "expected_behavior": "Returns JSON catalog of ARD resources",
      "metrics": ["latency", "status_code", "accuracy"],
      "validation": {"field": "root", "type": "object"}
    },
    {
      "name": "query_findings_default",
      "endpoint": "/findings?sort_by=weight&min_votes=0",
      "method": "GET",
      "headers": {},
      "payload": {},
      "expected_status": 200,
      "intent": "happy_path",
      "expected_behavior": "Returns array of Finding objects sorted by weight",
      "metrics": ["latency", "status_code", "accuracy"],
      "validation": {"field": "root", "type": "array"}
    },
    {
      "name": "query_findings_filters",
      "endpoint": "/findings?category=entry_signal&min_votes=1&regime=bull&sort_by=newest",
      "method": "GET",
      "headers": {},
      "payload": {},
      "expected_status": 200,
      "intent": "happy_path",
      "expected_behavior": "Returns filtered array of findings honoring all query params",
      "metrics": ["latency", "status_code", "accuracy"],
      "validation": {"field": "root", "type": "array", "min_length": 0}
    },
    {
      "name": "query_findings_bad_sort_by",
      "endpoint": "/findings?sort_by=bogus",
      "method": "GET",
      "headers": {},
      "payload": {},
      "expected_status": 422,
      "intent": "validation",
      "expected_behavior": "Rejects sort_by value violating ^(weight|newest)$ pattern with structured HTTPValidationError",
      "metrics": ["status_code", "accuracy"],
      "validation": {"field": "detail", "type": "array", "min_length": 1}
    },
    {
      "name": "findings_tickers_fresh",
      "endpoint": "/findings/tickers?min_weight=0.0",
      "method": "GET",
      "headers": {},
      "payload": {},
      "expected_status": 200,
      "intent": "happy_path",
      "expected_behavior": "Returns fresh findings carrying stock tickers as candidate queue",
      "metrics": ["latency", "status_code", "accuracy"],
      "validation": {"field": "root", "type": "array"}
    },
    {
      "name": "publish_finding_valid",
      "endpoint": "/findings",
      "method": "POST",
      "headers": {"Content-Type": "application/json"},
      "payload": {
        "category": "entry_signal",
        "claim": "Prowl benchmark probe: momentum breakout above 20-day high in Technology sector correlates with 3-day continuation.",
        "hypothesis": "Higher highs with volume expansion predict short-term continuation.",
        "published_by": "prowl-benchmark-probe",
        "status": "closed",
        "execution_env": "paper",
        "evidence": "Benchmark synthetic probe; not a real trading claim.",
        "trade_count": 12,
        "win_rate": 0.58,
        "tickers": ["AAPL"]
      },
      "expected_status": 201,
      "intent": "happy_path",
      "expected_behavior": "Creates and returns the new Finding object",
      "metrics": ["latency", "status_code", "accuracy"],
      "validation": {"field": "finding_id", "type": "string"}
    },
    {
      "name": "publish_finding_missing_claim",
      "endpoint": "/findings",
      "method": "POST",
      "headers": {"Content-Type": "application/json"},
      "payload": {
        "category": "entry_signal",
        "published_by": "prowl-benchmark-probe"
      },
      "expected_status": 422,
      "intent": "validation",
      "expected_behavior": "Rejects payload missing required 'claim' field with structured HTTPValidationError",
      "metrics": ["status_code", "accuracy"],
      "validation": {"field": "detail", "type": "array", "min_length": 1}
    },
    {
      "name": "publish_finding_bad_category",
      "endpoint": "/findings",
      "method": "POST",
      "headers": {"Content-Type": "application/json"},
      "payload": {
        "category": "not_a_real_category",
        "claim": "This claim is long enough to pass the min length check on the claim field.",
        "published_by": "prowl-benchmark-probe"
      },
      "expected_status": 422,
      "intent": "validation",
      "expected_behavior": "Rejects category outside the declared enum with structured validation error",
      "metrics": ["status_code", "accuracy"],
      "validation": {"field": "detail", "type": "array", "min_length": 1}
    },
    {
      "name": "get_finding_by_id",
      "endpoint": "/findings/00000000-0000-0000-0000-000000000000",
      "method": "GET",
      "headers": {},
      "payload": {},
      "expected_status": 200,
      "intent": "stress",
      "expected_behavior": "Either returns a Finding (200) or a handled not-found response; must not 5xx on an unknown-but-well-formed id",
      "metrics": ["latency", "status_code"],
      "validation": {"field": "root", "type": "object"}
    },
    {
      "name": "network_brief_sector_regime",
      "

8/12 tests passed

{"model": "deepseek", "data": {"overall": 72, "dimensions": {"token_efficiency": 7.0, "first_try_success": 8.0, "response_parseability": 9.0, "error_clarity": 9.0, "doc_quality": 6.0, "auth_simplicity": 10.0, "latency": 10.0, "consistency": 7.0}, "pricing_normalized": {"cost_per_1k_requests": null, "cost_per_1m_input_tokens": null, "cost_per_1m_output_tokens": null, "free_tier_requests": null, "estimated_monthly_cost_light": null, "estimated_monthly_cost_heavy": null}, "issues": [{"severity": "high", "detail": "Invalid query parameter values (e.g. sort_by=bogus) are silently ignored and return 200 with unfiltered results instead of a 4xx validation error. Agents cannot trust that their query filters were applied \u2014 silent filter failure can lead to acting on wrong data.", "endpoint": "/findings"}, {"severity": "medium", "detail": "MCP handler GET returned 406 requiring 'Accept: text/event-stream'; this isn't documented in the catalog preview and will trip agents that assume JSON. The endpoint also appears to expect a different client contract (JSON-RPC over SSE) than plain GET.", "endpoint": "/mcp"}, {"severity": "medium", "detail": "findings_tickers_fresh returned an empty response_preview (null) \u2014 cannot verify the response shape; agents may need to probe further to know the schema.", "endpoint": "/findings/tickers"}, {"severity": "low", "detail": "404 error body is minimal ({'detail': 'Finding not found'}) without a code or suggestion; acceptable but not field-level rich.", "endpoint": "/findings/{finding_id}"}, {"severity": "low", "detail": "No pricing/free-tier information surfaced. Access is 'contribution_gated' (publish first, then query), but the specific query-access thresholds per tier are truncated in the catalog preview and not clearly enumerated for agents.", "endpoint": "/ai-catalog.json"}], "recommendations": ["Enable strict validation on query parameters \u2014 return 422 with a structured error when sort_by, category, regime, or other enum-like filters receive invalid values, rather than silently ignoring them.", "Document the MCP endpoint contract explicitly, including required Accept/Content-Type headers for SSE/JSON-RPC, and provide an example request and response in the catalog.", "Ensure /findings/tickers returns a stable, non-empty JSON array shape even when there are no matches, and include it in the catalog spec.", "Publish a concise OpenAPI/JSON schema for findings objects (field names, types, enums for status/execution_env/category) so agents can construct and parse payloads without guessing.", "Expose the contribution-gated tier thresholds explicitly in the catalog (publish counts needed to unlock each query tier) so agents can reason about access.", "Add a pricing/free-tier block (even 'free with contribution') to pricing_model so cost estimation is deterministic."]}}