API Documentation

The Decision Support Network REST API provides programmatic access to all verified Decision Support Assets. All endpoints return JSON and support CORS.

OpenAPI 3.1 Spec →Capability Manifest →

Base URL

/api/v1

GET/api/v1/tools

Returns a paginated list of active Decision Support Assets with optional filters.

Query Parameters

categorystringFilter by category slug

geographystringFilter by geography (partial match)

verificationstringFilter by verification level

capabilityenumwebmcp | rest | mcp

pageintegerPage number (default: 1)

limitintegerResults per page (default: 50, max: 100)

GET/api/v1/tools/:slug

Returns full details for a specific DSA by slug. Returns 404 if not found.

POST/api/v1/find-tool

Uses the CCA routing engine to find the most relevant DSA(s) for a natural-language decision query.

Request Body

{
  "query": "I need help evaluating a solar proposal",
  "geography": "California",  // optional
  "category": "solar-energy",  // optional
  "audience": "homeowner",     // optional
  "max_results": 5             // optional, default 5
}

Response

{
  "tools": [
    {
      "dsa": { /* full DSA record */ },
      "matchScore": 92,
      "matchExplanation": "Matches because...",
      "rank": 1
    }
  ],
  "noMatch": false,
  "query": "I need help evaluating a solar proposal",
  "totalFound": 1
}

GET/api/v1/categories

Returns all categories with their DSA counts.

POST/api/mcpJSON-RPC 2.0

Remote MCP endpoint. Supports initialize, tools/list, tools/call.

Available tools: find_decision_support_tool, get_decision_tool_details, list_decision_support_categories