List models
The ostra_list_models tool on the Ostra MCP server — arguments, result, errors and examples.
MCP
https://ostra.testrelic.ai/mcp · ostra_list_modelsLists the Ostra models, their tasks and prices. Free, and works with read-only keys.
- Title
- List Ostra models
- Access
- Any key, read-only included.
- Cost
- Free; not rate limited.
- Hints
- readOnlyHint: true · destructiveHint: false · idempotentHint: true · openWorldHint: false
- Over REST
- GET /api/v1/models
Once the Ostra MCP server is connected, your agent calls the tool with these arguments.
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "ostra_list_models",
"arguments": {}
}
}curl https://ostra.testrelic.ai/mcp \
-H "Authorization: Bearer $OSTRA_API_KEY" \
-H 'Content-Type: application/json' \
-H 'Accept: application/json, text/event-stream' \
-H 'MCP-Protocol-Version: 2025-06-18' \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "ostra_list_models",
"arguments": {}
}
}'import os
import requests
response = requests.post(
"https://ostra.testrelic.ai/mcp",
headers={
"Authorization": f"Bearer {os.environ['OSTRA_API_KEY']}",
"Accept": "application/json, text/event-stream",
"MCP-Protocol-Version": "2025-06-18",
},
json={
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "ostra_list_models",
"arguments": {},
},
},
timeout=60,
)
response.raise_for_status()
print(response.json())const response = await fetch('https://ostra.testrelic.ai/mcp', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.OSTRA_API_KEY}`,
'Content-Type': 'application/json',
Accept: 'application/json, text/event-stream',
'MCP-Protocol-Version': '2025-06-18',
},
body: JSON.stringify({
jsonrpc: '2.0',
id: 1,
method: 'tools/call',
params: {
name: 'ostra_list_models',
arguments: {},
},
}),
});
if (!response.ok) {
throw new Error(`Ostra ${response.status}: ${await response.text()}`);
}
console.log(await response.json());package main
import (
"fmt"
"io"
"net/http"
"os"
"strings"
)
func main() {
body := strings.NewReader(`{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "ostra_list_models",
"arguments": {}
}
}`)
req, err := http.NewRequest("POST", "https://ostra.testrelic.ai/mcp", body)
if err != nil {
panic(err)
}
req.Header.Set("Authorization", "Bearer "+os.Getenv("OSTRA_API_KEY"))
req.Header.Set("Content-Type", "application/json")
req.Header.Set("Accept", "application/json, text/event-stream")
req.Header.Set("MCP-Protocol-Version", "2025-06-18")
res, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer res.Body.Close()
out, err := io.ReadAll(res.Body)
if err != nil {
panic(err)
}
fmt.Println(res.Status)
fmt.Println(string(out))
}import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
public class OstraExample {
public static void main(String[] args) throws Exception {
String body = """
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "ostra_list_models",
"arguments": {}
}
}
""";
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://ostra.testrelic.ai/mcp"))
.header("Authorization", "Bearer " + System.getenv("OSTRA_API_KEY"))
.header("Content-Type", "application/json")
.header("Accept", "application/json, text/event-stream")
.header("MCP-Protocol-Version", "2025-06-18")
.POST(HttpRequest.BodyPublishers.ofString(body))
.build();
HttpResponse<String> response = HttpClient.newHttpClient()
.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.statusCode());
System.out.println(response.body());
}
}using System.Net.Http.Headers;
using System.Text;
using var client = new HttpClient();
client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", Environment.GetEnvironmentVariable("OSTRA_API_KEY"));
client.DefaultRequestHeaders.Accept.Add(new MediaTypeWithQualityHeaderValue("application/json"));
client.DefaultRequestHeaders.Accept.Add(new MediaTypeWithQualityHeaderValue("text/event-stream"));
client.DefaultRequestHeaders.Add("MCP-Protocol-Version", "2025-06-18");
using var request = new HttpRequestMessage(HttpMethod.Post, "https://ostra.testrelic.ai/mcp");
request.Content = new StringContent(
"""
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "ostra_list_models",
"arguments": {}
}
}
""",
Encoding.UTF8,
"application/json");
using var response = await client.SendAsync(request);
Console.WriteLine((int)response.StatusCode);
Console.WriteLine(await response.Content.ReadAsStringAsync());require "net/http"
require "uri"
uri = URI("https://ostra.testrelic.ai/mcp")
request = Net::HTTP::Post.new(uri)
request["Authorization"] = "Bearer #{ENV.fetch("OSTRA_API_KEY")}"
request["Content-Type"] = "application/json"
request["Accept"] = "application/json, text/event-stream"
request["MCP-Protocol-Version"] = "2025-06-18"
request.body = <<~'JSON'
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "ostra_list_models",
"arguments": {}
}
}
JSON
response = Net::HTTP.start(uri.host, uri.port, use_ssl: true) { |http| http.request(request) }
puts response.code
puts response.body<?php
$ch = curl_init("https://ostra.testrelic.ai/mcp");
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
"Authorization: Bearer " . getenv("OSTRA_API_KEY"),
"Content-Type: application/json",
"Accept: application/json, text/event-stream",
"MCP-Protocol-Version: 2025-06-18",
],
CURLOPT_POSTFIELDS => <<<'JSON'
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "ostra_list_models",
"arguments": {}
}
}
JSON,
]);
$response = curl_exec($ch);
echo curl_getinfo($ch, CURLINFO_HTTP_CODE), PHP_EOL;
echo $response, PHP_EOL;Headers
- mcp-protocol-version
- 2025-06-18
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"content": [
{
"type": "text",
"text": "{\"object\":\"list\",\"data\":[{\"id\":\"ostra-lite\",\"name\":\"Ostra Decision\",\"status\":\"beta\",\"release\":\"v.beta.5\",\"tasks\":[{\"task\":\"triage\",\"name\":\"Failure triage\",\"description\":\"Classifies a failing test as flaky, product bug, test bug, environment or selector drift.\",\"mcpTool\":\"ostra_triage_failure\",\"rateLabel\":\"$0.50 / 1M failures\",\"outputRateLabel\":\"$0.00 / 1M decisions\",\"version\":\"1.4.0\",\"contentHash\":\"sha256:3f9a1c07d2e4b8a6\",\"gatePassed\":true,\"classes\":[\"flaky\",\"product_bug\",\"test_bug\",\"environment\",\"selector_drift\"],\"deferThreshold\":0.6},{\"task\":\"test_impact\",\"name\":\"Test impact\",\"description\":\"Ranks candidate tests by the probability that a diff breaks them.\",\"mcpTool\":\"ostra_select_impacted_tests\",\"rateLabel\":\"$2.00 / 1M diffs\",\"outputRateLabel\":\"$0.00 / 1M decisions\",\"version\":\"1.1.2\",\"contentHash\":\"sha256:a07be3315c9d4f12\",\"gatePassed\":true,\"classes\":[\"not_impacted\",\"impacted\"],\"deferThreshold\":0.55},{\"task\":\"selector_survival\",\"name\":\"Selector survival\",\"description\":\"Predicts whether UI locators survive the next release.\",\"mcpTool\":\"ostra_check_selector\",\"rateLabel\":\"$0.25 / 1M selectors\",\"outputRateLabel\":\"$0.00 / 1M decisions\",\"version\":\"1.2.0\",\"contentHash\":\"sha256:5d21f0e9c4a7b3e8\",\"gatePassed\":true,\"classes\":[\"survives\",\"breaks\"],\"deferThreshold\":0.6}],\"pricing\":{\"input\":\"$0.25–$2.00 / 1M inputs\",\"output\":\"$0.00 / 1M decisions\"},\"latencyP50Ms\":41,\"requests7d\":1284},{\"id\":\"ostra-pro\",\"object\":\"model\",\"created\":1794873600,\"owned_by\":\"testrelic\",\"name\":\"Ostra Pro\",\"version\":\"1.0\",\"base_url\":\"https://ostra.testrelic.ai/api/v1\",\"context_window\":262144,\"max_output_tokens\":32768,\"pricing\":{\"input\":\"$0.64 / 1M input tokens\",\"cached_input\":\"$0.06 / 1M cached input tokens\",\"output\":\"$4.47 / 1M output tokens\"},\"mcp_tool\":\"ostra_pro_chat\"}]}"
}
],
"structuredContent": {
"object": "list",
"data": [
{
"id": "ostra-lite",
"name": "Ostra Decision",
"status": "beta",
"release": "v.beta.5",
"tasks": [
{
"task": "triage",
"name": "Failure triage",
"description": "Classifies a failing test as flaky, product bug, test bug, environment or selector drift.",
"mcpTool": "ostra_triage_failure",
"rateLabel": "$0.50 / 1M failures",
"outputRateLabel": "$0.00 / 1M decisions",
"version": "1.4.0",
"contentHash": "sha256:3f9a1c07d2e4b8a6",
"gatePassed": true,
"classes": [
"flaky",
"product_bug",
"test_bug",
"environment",
"selector_drift"
],
"deferThreshold": 0.6
},
{
"task": "test_impact",
"name": "Test impact",
"description": "Ranks candidate tests by the probability that a diff breaks them.",
"mcpTool": "ostra_select_impacted_tests",
"rateLabel": "$2.00 / 1M diffs",
"outputRateLabel": "$0.00 / 1M decisions",
"version": "1.1.2",
"contentHash": "sha256:a07be3315c9d4f12",
"gatePassed": true,
"classes": [
"not_impacted",
"impacted"
],
"deferThreshold": 0.55
},
{
"task": "selector_survival",
"name": "Selector survival",
"description": "Predicts whether UI locators survive the next release.",
"mcpTool": "ostra_check_selector",
"rateLabel": "$0.25 / 1M selectors",
"outputRateLabel": "$0.00 / 1M decisions",
"version": "1.2.0",
"contentHash": "sha256:5d21f0e9c4a7b3e8",
"gatePassed": true,
"classes": [
"survives",
"breaks"
],
"deferThreshold": 0.6
}
],
"pricing": {
"input": "$0.25–$2.00 / 1M inputs",
"output": "$0.00 / 1M decisions"
},
"latencyP50Ms": 41,
"requests7d": 1284
},
{
"id": "ostra-pro",
"object": "model",
"created": 1794873600,
"owned_by": "testrelic",
"name": "Ostra Pro",
"version": "1.0",
"base_url": "https://ostra.testrelic.ai/api/v1",
"context_window": 262144,
"max_output_tokens": 32768,
"pricing": {
"input": "$0.64 / 1M input tokens",
"cached_input": "$0.06 / 1M cached input tokens",
"output": "$4.47 / 1M output tokens"
},
"mcp_tool": "ostra_pro_chat"
}
]
},
"isError": false
}
}Arguments
None. Call it with an empty object.
Result
content[0].text holds the answer as text; structuredContent holds it as JSON:
objectstringlist.dataarray of objectsThe same entries as
GET /models.
Errors
Billing, validation, rate-limit and permission problems come back as a normal result with isError: true and structuredContent.error (type, message), the same types as the REST errors. Authentication failures are HTTP 401/403 before any JSON-RPC.
Was this page helpful?