Check selectors
The ostra_check_selector tool on the Ostra MCP server — arguments, result, errors and examples.
https://ostra.testrelic.ai/mcp · ostra_check_selectorPredicts whether each locator will survive the next release or break.
- Title
- Ostra Decision: Selector survival
- Access
- Full-access key. Read-only keys can list the tool but not call it.
- Cost
- $0.25 per 1M locators.
- Hints
- readOnlyHint: true · destructiveHint: false · idempotentHint: true · openWorldHint: false
- Over REST
- POST /api/v1/predict
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_check_selector",
"arguments": {
"locators": [
{
"locator_id": "checkout.apply-coupon",
"strategy": "css",
"dom_locator_found": true,
"history": [
{
"release": "2026.10.1",
"resolve_rate": 1
},
{
"release": "2026.10.2",
"resolve_rate": 0.92
},
{
"release": "2026.11.1",
"resolve_rate": 0.71
}
]
},
{
"locator_id": "nav.account-menu",
"strategy": "role",
"dom_locator_found": true,
"history": [
{
"release": "2026.10.2",
"resolve_rate": 1
},
{
"release": "2026.11.1",
"resolve_rate": 1
}
]
}
]
}
}
}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_check_selector",
"arguments": {
"locators": [
{
"locator_id": "checkout.apply-coupon",
"strategy": "css",
"dom_locator_found": true,
"history": [
{
"release": "2026.10.1",
"resolve_rate": 1
},
{
"release": "2026.10.2",
"resolve_rate": 0.92
},
{
"release": "2026.11.1",
"resolve_rate": 0.71
}
]
},
{
"locator_id": "nav.account-menu",
"strategy": "role",
"dom_locator_found": true,
"history": [
{
"release": "2026.10.2",
"resolve_rate": 1
},
{
"release": "2026.11.1",
"resolve_rate": 1
}
]
}
]
}
}
}'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_check_selector",
"arguments": {
"locators": [
{
"locator_id": "checkout.apply-coupon",
"strategy": "css",
"dom_locator_found": True,
"history": [
{
"release": "2026.10.1",
"resolve_rate": 1,
},
{
"release": "2026.10.2",
"resolve_rate": 0.92,
},
{
"release": "2026.11.1",
"resolve_rate": 0.71,
},
],
},
{
"locator_id": "nav.account-menu",
"strategy": "role",
"dom_locator_found": True,
"history": [
{
"release": "2026.10.2",
"resolve_rate": 1,
},
{
"release": "2026.11.1",
"resolve_rate": 1,
},
],
},
],
},
},
},
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_check_selector',
arguments: {
locators: [
{
locator_id: 'checkout.apply-coupon',
strategy: 'css',
dom_locator_found: true,
history: [
{
release: '2026.10.1',
resolve_rate: 1,
},
{
release: '2026.10.2',
resolve_rate: 0.92,
},
{
release: '2026.11.1',
resolve_rate: 0.71,
},
],
},
{
locator_id: 'nav.account-menu',
strategy: 'role',
dom_locator_found: true,
history: [
{
release: '2026.10.2',
resolve_rate: 1,
},
{
release: '2026.11.1',
resolve_rate: 1,
},
],
},
],
},
},
}),
});
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_check_selector",
"arguments": {
"locators": [
{
"locator_id": "checkout.apply-coupon",
"strategy": "css",
"dom_locator_found": true,
"history": [
{
"release": "2026.10.1",
"resolve_rate": 1
},
{
"release": "2026.10.2",
"resolve_rate": 0.92
},
{
"release": "2026.11.1",
"resolve_rate": 0.71
}
]
},
{
"locator_id": "nav.account-menu",
"strategy": "role",
"dom_locator_found": true,
"history": [
{
"release": "2026.10.2",
"resolve_rate": 1
},
{
"release": "2026.11.1",
"resolve_rate": 1
}
]
}
]
}
}
}`)
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_check_selector",
"arguments": {
"locators": [
{
"locator_id": "checkout.apply-coupon",
"strategy": "css",
"dom_locator_found": true,
"history": [
{
"release": "2026.10.1",
"resolve_rate": 1
},
{
"release": "2026.10.2",
"resolve_rate": 0.92
},
{
"release": "2026.11.1",
"resolve_rate": 0.71
}
]
},
{
"locator_id": "nav.account-menu",
"strategy": "role",
"dom_locator_found": true,
"history": [
{
"release": "2026.10.2",
"resolve_rate": 1
},
{
"release": "2026.11.1",
"resolve_rate": 1
}
]
}
]
}
}
}
""";
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_check_selector",
"arguments": {
"locators": [
{
"locator_id": "checkout.apply-coupon",
"strategy": "css",
"dom_locator_found": true,
"history": [
{
"release": "2026.10.1",
"resolve_rate": 1
},
{
"release": "2026.10.2",
"resolve_rate": 0.92
},
{
"release": "2026.11.1",
"resolve_rate": 0.71
}
]
},
{
"locator_id": "nav.account-menu",
"strategy": "role",
"dom_locator_found": true,
"history": [
{
"release": "2026.10.2",
"resolve_rate": 1
},
{
"release": "2026.11.1",
"resolve_rate": 1
}
]
}
]
}
}
}
""",
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_check_selector",
"arguments": {
"locators": [
{
"locator_id": "checkout.apply-coupon",
"strategy": "css",
"dom_locator_found": true,
"history": [
{
"release": "2026.10.1",
"resolve_rate": 1
},
{
"release": "2026.10.2",
"resolve_rate": 0.92
},
{
"release": "2026.11.1",
"resolve_rate": 0.71
}
]
},
{
"locator_id": "nav.account-menu",
"strategy": "role",
"dom_locator_found": true,
"history": [
{
"release": "2026.10.2",
"resolve_rate": 1
},
{
"release": "2026.11.1",
"resolve_rate": 1
}
]
}
]
}
}
}
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_check_selector",
"arguments": {
"locators": [
{
"locator_id": "checkout.apply-coupon",
"strategy": "css",
"dom_locator_found": true,
"history": [
{
"release": "2026.10.1",
"resolve_rate": 1
},
{
"release": "2026.10.2",
"resolve_rate": 0.92
},
{
"release": "2026.11.1",
"resolve_rate": 0.71
}
]
},
{
"locator_id": "nav.account-menu",
"strategy": "role",
"dom_locator_found": true,
"history": [
{
"release": "2026.10.2",
"resolve_rate": 1
},
{
"release": "2026.11.1",
"resolve_rate": 1
}
]
}
]
}
}
}
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": "{\"id\":\"req_01JDXK6P7Q8R9S0T1U2V3W4X5Y\",\"model\":\"ostra-lite@v.beta.5\",\"task\":\"selector_survival\",\"cached\":false,\"billed\":{\"units\":2,\"costNano\":500,\"costUsd\":\"0.0000005\"},\"output\":{\"decisions\":[{\"decision_id\":\"dec_4d5e6f708192a3b4c5d6e7f8091a2b3c\",\"task\":\"selector_survival\",\"decision\":\"breaks\",\"value\":\"breaks\",\"p\":0.78,\"probabilities\":{\"survives\":0.22,\"breaks\":0.78},\"threshold\":0.6,\"defer_reason\":null,\"decided_by\":\"model\",\"rule\":null,\"model\":{\"release\":\"v.beta.5\",\"version\":\"1.2.0\",\"content_hash\":\"sha256:5d21f0e9c4a7b3e8\",\"gate_passed\":true},\"locator_id\":\"checkout.apply-coupon\"},{\"decision_id\":\"dec_5e6f708192a3b4c5d6e7f8091a2b3c4d\",\"task\":\"selector_survival\",\"decision\":\"survives\",\"value\":\"survives\",\"p\":0.96,\"probabilities\":{\"survives\":0.96,\"breaks\":0.04},\"threshold\":0.6,\"defer_reason\":null,\"decided_by\":\"model\",\"rule\":null,\"model\":{\"release\":\"v.beta.5\",\"version\":\"1.2.0\",\"content_hash\":\"sha256:5d21f0e9c4a7b3e8\",\"gate_passed\":true},\"locator_id\":\"nav.account-menu\"}]}}"
}
],
"structuredContent": {
"id": "req_01JDXK6P7Q8R9S0T1U2V3W4X5Y",
"model": "ostra-lite@v.beta.5",
"task": "selector_survival",
"cached": false,
"billed": {
"units": 2,
"costNano": 500,
"costUsd": "0.0000005"
},
"output": {
"decisions": [
{
"decision_id": "dec_4d5e6f708192a3b4c5d6e7f8091a2b3c",
"task": "selector_survival",
"decision": "breaks",
"value": "breaks",
"p": 0.78,
"probabilities": {
"survives": 0.22,
"breaks": 0.78
},
"threshold": 0.6,
"defer_reason": null,
"decided_by": "model",
"rule": null,
"model": {
"release": "v.beta.5",
"version": "1.2.0",
"content_hash": "sha256:5d21f0e9c4a7b3e8",
"gate_passed": true
},
"locator_id": "checkout.apply-coupon"
},
{
"decision_id": "dec_5e6f708192a3b4c5d6e7f8091a2b3c4d",
"task": "selector_survival",
"decision": "survives",
"value": "survives",
"p": 0.96,
"probabilities": {
"survives": 0.96,
"breaks": 0.04
},
"threshold": 0.6,
"defer_reason": null,
"decided_by": "model",
"rule": null,
"model": {
"release": "v.beta.5",
"version": "1.2.0",
"content_hash": "sha256:5d21f0e9c4a7b3e8",
"gate_passed": true
},
"locator_id": "nav.account-menu"
}
]
}
},
"isError": false
}
}{
"jsonrpc": "2.0",
"id": 1,
"result": {
"content": [
{
"type": "text",
"text": "Your balance ($0.00) does not cover this request ($0.0000005). Top up in the TestRelic Console."
}
],
"structuredContent": {
"error": {
"type": "insufficient_balance",
"message": "Your balance ($0.00) does not cover this request ($0.0000005). Top up in the TestRelic Console.",
"balance_usd": "0.00",
"cost_usd": "0.0000005"
}
},
"isError": true
}
}Arguments
locatorsarray of objectsRequiredThe locators to check. Billed per locator.
1–500 itemsShow 4 child fieldsHide child fields
locator_idstringYour identifier for the locator, echoed back.
1–512 charsstrategystringHow the locator finds its element.
One ofcssxpathtest_idtextrolenonedom_locator_foundbooleanThe locator matches an element in the current build’s DOM.
historyarray of objectsHow well the locator resolved in past releases, oldest first.
0–100 itemsShow 2 child fieldsHide child fields
releasestringRequiredRelease label, e.g.
2026.11.1.1–128 charsresolve_ratenumberShare of runs in that release where the locator resolved, 0–1.
0 to 1
Result
content[0].text holds the answer as text; structuredContent holds it as JSON:
idstringRequest id.
modelstringModel and release, e.g.
ostra-lite@v.beta.5.taskstringThe task.
cachedbooleanAnswered from the 24-hour cache.
billedobjectWhat this request cost. Cached answers cost 0.
Show 3 child fieldsHide child fields
unitsintegerBillable units: 1 per failure (triage), 1 per request (test impact), 1 per locator (selector survival). 0 for a cached answer.
costNanointegerCost in nano-dollars (1 USD = 1,000,000,000).
costUsdstringCost in USD as an exact decimal string, e.g.
"0.0000005".
outputobjectThe task’s answer, the same shape as
/predict.
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.