Agent-CoreX Documentation

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"
  }
}

{
  "success": false,
  "error": {
    "code": "INVALID_REQUEST",
    "message": "<string>",
    "details": {}
  },
  "meta": {
    "request_id": "<string>",
    "timestamp": "2023-11-07T05:31:56Z"
  }
}

{
  "success": false,
  "error": {
    "code": "INVALID_REQUEST",
    "message": "<string>",
    "details": {}
  },
  "meta": {
    "request_id": "<string>",
    "timestamp": "2023-11-07T05:31:56Z"
  }
}

{
  "success": false,
  "error": {
    "code": "INVALID_REQUEST",
    "message": "<string>",
    "details": {}
  },
  "meta": {
    "request_id": "<string>",
    "timestamp": "2023-11-07T05:31:56Z"
  }
}

{
  "success": false,
  "error": {
    "code": "INVALID_REQUEST",
    "message": "<string>",
    "details": {}
  },
  "meta": {
    "request_id": "<string>",
    "timestamp": "2023-11-07T05:31:56Z"
  }
}

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"
  }
}

{
  "success": false,
  "error": {
    "code": "INVALID_REQUEST",
    "message": "<string>",
    "details": {}
  },
  "meta": {
    "request_id": "<string>",
    "timestamp": "2023-11-07T05:31:56Z"
  }
}

{
  "success": false,
  "error": {
    "code": "INVALID_REQUEST",
    "message": "<string>",
    "details": {}
  },
  "meta": {
    "request_id": "<string>",
    "timestamp": "2023-11-07T05:31:56Z"
  }
}

{
  "success": false,
  "error": {
    "code": "INVALID_REQUEST",
    "message": "<string>",
    "details": {}
  },
  "meta": {
    "request_id": "<string>",
    "timestamp": "2023-11-07T05:31:56Z"
  }
}

{
  "success": false,
  "error": {
    "code": "INVALID_REQUEST",
    "message": "<string>",
    "details": {}
  },
  "meta": {
    "request_id": "<string>",
    "timestamp": "2023-11-07T05:31:56Z"
  }
}

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

Show child attributes

user_id

string

Override current user (admin only)

Response

Tools retrieved successfully

success

boolean

Example:

true

data

object

Show child attributes

meta

object

Show child attributes