submit_adrata_command
Submit a governed Adrata Cloud command through the same command plane used by the app and CLI. Defaults to dry-run preview. Use execute only when the user asked for a write and you have an idempotency key; high-risk writes require approval.
This record as markdown: /tools/adrata-starfield-mcp/submit-adrata-command.md
What submit_adrata_command does on Starfield
AI agents use submit_adrata_command to create or update resources in Starfield, usually the action step of a workflow, after the agent has gathered context. Every call changes real data in your Starfield environment.
| Parameter | Type | Required | Description |
|---|---|---|---|
mode | string | — | Defaults to dry_run. execute queues the command if policy allows it. |
reason | string | — | Human-readable reason for audit and approval review. |
payload | object | — | Command-specific target, record ids, changes, and context. |
commandId | string | — | Optional caller-provided command id. |
approvalId | string | — | Approval id for high-risk execute commands. |
commandType | string | Yes | Command type such as path_to_power, research_account, update_buyer_group, request_intro, move_person_to_lead, create_next_action, or sync_crm |
idempotencyKey | string | — | Required for safe execute retries; generated by the API if omitted. |
Parameters from the server's own tool schema.
Why submit_adrata_command is rated Medium
An AI agent can call submit_adrata_command faster than any human can review: one bad instruction and it creates or modifies resources in Starfield by the hundred, each call as confident as the last.
Risk signalsAccepts raw HTML/template content (payload)
Attacks that exploit this kind of access
The rule that runs submit_adrata_command safely
PolicyLayer is an MCP gateway: it sits between your AI agents and Starfield, and checks every tool call against a rule you set before the call runs. Nothing changes on the server itself. For submit_adrata_command, this is the rule to start with:
submit_adrata_command stays usable, but capped: an agent stuck in a loop can't make hundreds of changes a minute. Everything else on the server is denied unless you say otherwise.
The button opens the PolicyLayer dashboard: create your workspace, connect Starfield, apply this rule, and every submit_adrata_command call is checked against it from then on.
Questions about submit_adrata_command
Submit a governed Adrata Cloud command through the same command plane used by the app and CLI. Defaults to dry-run preview. Use execute only when the user asked for a write and you have an idempotency key; high-risk writes require approval. It is categorised as a Write tool in the Starfield MCP Server, which means it can create or modify data. Consider rate limits to prevent runaway writes.
submit_adrata_command accepts 7 parameters: mode, reason, payload, commandId, approvalId, commandType, idempotencyKey. Required: commandType. The full parameter table on this page comes from the server's own tool schema.
Register the Starfield MCP server in PolicyLayer and add a rule for submit_adrata_command: allow, deny, rate-limit, or require approval. Point your MCP client at the PolicyLayer proxy URL and the rule is enforced on every call, before it reaches Starfield. Nothing to install.
submit_adrata_command is a Write tool with medium risk. Write tools should be rate-limited to prevent accidental bulk modifications.
Yes. Add a rate_limit block to the submit_adrata_command rule in your PolicyLayer 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.
Set action: deny in the PolicyLayer policy for submit_adrata_command. 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.
submit_adrata_command is provided by the Starfield MCP server (@adrata/starfield-mcp). PolicyLayer sits as a proxy in front of this server to enforce policies before tool calls reach the server.
More on Starfield, and thousands of servers like it.
This server
Across the catalogue