Skip to main content
POST
/
retrieve_tools
curl --request POST \
  --url https://api.agent-corex.com/v1/retrieve_tools \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "query": "Create a GitHub pull request",
  "top_k": 5
}
'
{
  "success": true,
  "data": {
    "tools": [
      {
        "name": "create-pull-request",
        "server": "github-mcp",
        "score": 0.98,
        "description": "Create a new pull request on GitHub",
        "inputSchema": {
          "type": "object",
          "properties": {
            "repository": {
              "type": "string"
            },
            "title": {
              "type": "string"
            }
          }
        }
      },
      {
        "name": "deploy-aws-lambda",
        "server": "aws-mcp",
        "score": 0.95,
        "description": "Deploy function to AWS Lambda"
      }
    ],
    "query_time_ms": 45
  },
  "meta": {
    "request_id": "req_123abc",
    "timestamp": "2024-01-15T10:30:00Z"
  }
}

Authorizations

​
Authorization
string
header
required

JWT token obtained from dashboard

Body

application/json
​
query
string
required

Natural language query to find tools

Maximum string length: 500
Example:

"Create a GitHub pull request and deploy to production"

​
top_k
integer
default:5

Number of tools to return (max 50)

Required range: 1 <= x <= 50
​
filter
object

Optional filters for results

​
user_id
string

Override current user (admin only)

Response

Tools retrieved successfully

​
success
boolean
Example:

true

​
data
object
​
meta
object