MCP Tool Reference High Risk

run_agent_test

Run agent tests in a Salesforce org

Part of the Salesforce MCP server. Enforce policies on this tool with Intercept, the open-source MCP proxy.

@salesforce/mcp Execute

WHEN AI AGENTS USE THIS TOOL

AI agents invoke run_agent_test to trigger processes or run actions in Salesforce. Execute operations can have side effects beyond the immediate call — triggering builds, sending notifications, or starting workflows. Rate limits and argument validation are essential to prevent runaway execution.

WHY ENFORCE A POLICY ON RUN_AGENT_TEST

run_agent_test can trigger processes with real-world consequences. An uncontrolled agent might start dozens of builds, send mass notifications, or kick off expensive compute jobs. Intercept enforces rate limits and validates arguments to keep execution within safe bounds.

RECOMMENDED POLICY

Execute tools trigger processes. Rate-limit and validate arguments to prevent unintended side effects.

salesforce.yaml 
tools:
  run_agent_test:
    rules:
      - action: allow
        rate_limit:
          max: 10
          window: 60
        validate:
          required_args: true

See the full Salesforce policy for all 35 tools.

DETAILS

Tool Name

run_agent_test

Category

Execute

MCP Server

Salesforce MCP Server

Risk Level

High

MORE SALESFORCE TOOLS

run_code_analyzer Execute
Run Code Analyser on source code
run_apex_test Execute
Run Apex tests in a Salesforce org
resume_tool_operation Execute
Resume a tool operation
scan-apex-antipatterns Execute
Scan Apex code for anti-patterns
get_username Read
Get the current Salesforce username
list_all_orgs Read
List all connected Salesforce orgs
retrieve_metadata Read
Retrieve metadata from a Salesforce org
run_soql_query Read
Run a SOQL query against a Salesforce org

View all 35 tools →

SIMILAR EXECUTE TOOLS ON OTHER SERVERS

call-actor Apify
Call an Actor and get its run results
boot_simulator Appium
Boot an iOS simulator
setup_wda Appium
Download and setup WebDriverAgent for iOS simulators
install_wda Appium
Install and launch WebDriverAgent on an iOS simulator
auth0_deploy_action Auth0
Deploy an Auth0 action
auth0_publish_form Auth0
Publish an Auth0 form

RELATED READING

FREQUENTLY ASKED QUESTIONS

What does the run_agent_test tool do?

Run agent tests in a Salesforce org. It is categorised as a Execute tool in the Salesforce MCP Server, which means it can trigger actions or run processes. Use rate limits and argument validation.

How do I enforce a policy on run_agent_test?

Add a rule in your Intercept YAML policy under the tools section for run_agent_test. You can allow, deny, rate-limit, or validate arguments. Then run Intercept as a proxy in front of the Salesforce MCP server.

What risk level is run_agent_test?

run_agent_test is a Execute tool with high risk. Execute tools should be rate-limited and have argument validation enabled.

Can I rate-limit run_agent_test?

Yes. Add a rate_limit block to the run_agent_test rule in your Intercept policy. For example, setting max: 10 and window: 60 limits the tool to 10 calls per minute. Rate limits are tracked per agent session and reset automatically.

How do I block run_agent_test completely?

Set action: deny in the Intercept policy for run_agent_test. The AI agent will receive a policy violation error and cannot call the tool. You can also include a reason field to explain why the tool is blocked.

What MCP server provides run_agent_test?

run_agent_test is provided by the Salesforce MCP server (@salesforce/mcp). Intercept sits as a proxy in front of this server to enforce policies before tool calls reach the server.

ENFORCE POLICIES ON SALESFORCE

Open source. One binary. Zero dependencies.

VIEW ON GITHUB Full Salesforce policy →