Marketplace and Executing Tools

Browsing the marketplace

The marketplace lists all publicly published tools. You can filter by:

• Category
• Sector
• Runtime (Python, JavaScript, Lua)
• Compute type (CPU, GPU)
• Tags
• Creator / organization
• Pricing (free or paid)

Tools are sortable by relevance, rating, and execution count. Trending and top-rated tools are highlighted.

---

Tool details page

Each tool has a detail page showing:

• Description and overview
• Available versions
• Runtime and compute type
• Pricing per execution
• Usage documentation and examples
• Creator / organization

---

Executing a tool

Tools are executed by calling the cortex-connect gateway directly. You need:

1. The function ID (UUID) — shown on the tool’s detail page
2. The version — e.g. 1.0.0
3. An API key — generated from your account settings

Request format

curl --location 'https://cortexconnect.rival.io/api/v1/functions/{function_id}/{version}/invoke' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: <your_api_key>' \
  --data '{
    "event": {
      "your_key": "your_value"
    }
  }'

Example

curl --location 'https://cortexconnect.rival.io/api/v1/functions/4669e75e-0cf6-4c3a-a5e3-a8619ef28162/0.0.4/invoke' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: RIV_your_api_key_here' \
  --data '{
    "event": {
      "num": [10, 20, 30, 40, 50]
    }
  }'

Response

{
    "statusCode": 200,
    "body": "{\"sum\": 150, \"mean\": 30.0}",
    "summary": {
        "runtime_ms": 12,
        "memory_used_mb": 48,
        "compute_type": "python"
    }
}

Note

The body field in the response is a JSON string — parse it in your application to get the object your tool returned.

---

MCP tools

MCP tools follow the Model Context Protocol and are invoked with a JSON-RPC payload:

curl --location 'https://cortexconnect.rival.io/api/v1/functions/{function_id}/{version}/invoke' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: <your_api_key>' \
  --data '{
    "event": {
      "id": 1,
      "jsonrpc": "2.0",
      "method": "tools/list",
      "params": {}
    }
  }'

Common MCP methods: tools/list, tools/call.

---

Billing

Every execution has two cost components:

Compute cost — charged on every execution regardless of who runs the tool. This covers infrastructure (memory, CPU/GPU time).

Function cost — the per-execution fee set by the tool creator. This is only charged when you execute a tool outside your own organization.

Scenario	What you pay
Executing your own organization’s tool	Compute cost only (function fee is waived)
Executing another organization’s tool	Compute cost + function cost
Execution fails (error in code)	Nothing — failed executions are not charged
Insufficient balance	Execution is blocked with an error (HTTP 402)

Caution

If your balance is insufficient, the execution is blocked with an HTTP 402 error before the tool runs — you are not charged for blocked requests.

Top up your balance from the Billing section in account settings.

---

Favorites

You can favorite tools from the marketplace to save them for quick access. Favorites appear in your dashboard.