Atomic Red Team

`get_art_atomic_test`

Fetches the full details of a single Atomic Red Team test by its internal id, including executors, input arguments, and dependencies. Costs 1 credit.

POST

tools/call

Cost: 1 credit per successful call · Response shape: jsonb

Parameters

atomic_test_idintegerrequired

Internal Atomic Red Team test id. Must be 1 or greater. Obtain ids from list_art_atomic_tests.

Example invocation

Ask your agent: "Show me the full details of Atomic Red Team test 4012."

curl -s https://mcp.precursorintelligence.com \
  -H "Authorization: Bearer $PRECURSOR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_art_atomic_test","arguments":{"atomic_test_id":4012}}}'

Response

result.content[0].text (parsed)

{
  "id": 4012,
  "name": "PowerShell Base64 Encoded Command",
  "description": "Executes a base64-encoded PowerShell command to simulate an obfuscated script-based attack.",
  "auto_generated_guid": "a3b1c2d4-5e6f-7890-abcd-ef1234567890",
  "supported_platforms": ["windows"],
  "technique": {
    "attack_technique": "T1059.001",
    "display_name": "Command and Scripting Interpreter: PowerShell"
  },
  "executors": [
    {
      "id": 8201,
      "name": "powershell",
      "elevation_required": false,
      "command": "powershell.exe -EncodedCommand #{encoded_command}",
      "cleanup_command": null
    }
  ],
  "dependencies": [],
  "input_arguments": [
    {
      "id": 12045,
      "name": "encoded_command",
      "description": "Base64-encoded PowerShell command to execute",
      "type": "string",
      "default_value": "V3JpdGUtSG9zdCAnSGVsbG8gV29ybGQn"
    }
  ],
  "generated_at": "2026-05-29T10:14:07.221Z"
}

The full MCP envelope (including _meta.precursor with request_id, credits, and response_truncated) is described in Response Format.

Response fields

idintegeroptional

Internal id of the atomic test.

namestringoptional

Human-readable name of the atomic test.

descriptionstringoptional

What the test does and what adversary behavior it simulates.

auto_generated_guidstringoptional

Stable globally unique identifier assigned by the Atomic Red Team project.

supported_platformsstring[]optional

Platforms the test runs on (e.g. windows, linux, macos).

techniqueobjectoptional

MITRE ATT&CK technique this test maps to. Contains attack_technique (e.g. T1059.001) and display_name.

executorsobject[]optional

Executor definitions for the test. Each entry includes id, name (e.g. powershell, sh, command_prompt), elevation_required (boolean), command, and cleanup_command (nullable).

dependenciesobject[]optional

Prerequisites required before running the test. Each entry includes id, description, prereq_command, and get_prereq_command.

input_argumentsobject[]optional

Input variables the test accepts. Each entry includes id, name, description, type, and default_value.

generated_atstringoptional

ISO 8601 timestamp of when the response was generated.

Errors

Code	Message	When
`-32602`	`invalid_params: atomic_test_id: required_integer`	`atomic_test_id` is missing or not a positive integer.
`-32001`	`unauthorized`	The API key is invalid or revoked.
`-32002`	`insufficient_credits`	Your organisation has no credits remaining. Top up from the dashboard.
`-32603`	`internal`	An unexpected server error occurred. The credit is automatically refunded.

A well-formed id that does not match any test returns a successful response with { "error": "not_found" } in result.content[0].text; the credit is refunded automatically.

See Errors for the full error reference.