Retrieve Tools Endpoint

{
  "query": "Deploy to production and notify the team",
  "top_k": 5,
  "filter": {
    "server": "aws-mcp",
    "category": "infrastructure",
    "min_score": 0.85
  }
}

{
  "success": true,
  "data": {
    "tools": [
      {
        "name": "deploy-aws-ecs",
        "server": "aws-mcp",
        "score": 0.98,
        "description": "Deploy to AWS ECS cluster",
        "category": "infrastructure",
        "tags": ["aws", "deployment", "ecs"]
      }
    ],
    "query_time_ms": 45,
    "total_tools_searched": 156
  },
  "meta": {
    "request_id": "req_abc123",
    "timestamp": "2024-01-15T10:30:00Z"
  }
}

curl -X POST "https://api.agent-corex.com/v1/retrieve_tools" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "Send a Slack message"
  }'

curl -X POST "https://api.agent-corex.com/v1/retrieve_tools" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "Deploy",
    "top_k": 10,
    "filter": {
      "server": "aws-mcp",
      "min_score": 0.80
    }
  }'

const tools = await agent.retrieveTools({
  query: "Deploy to production",
  topK: 5
});

console.log(tools);

{
  "success": false,
  "error": {
    "code": "INVALID_REQUEST",
    "message": "Query is required",
    "details": {
      "parameter": "query"
    }
  }
}

{
  "success": false,
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Invalid API key"
  }
}

{
  "success": false,
  "error": {
    "code": "RATE_LIMITED",
    "message": "Too many requests",
    "retry_after": 60
  }
}