Register a target
create_targetRegister an agent or an MCP server you own or are authorized to test as a target for security assessments. Supply exactly one of: 'config' (the connection config of an agent endpoint that answers without a key: one live probe fires and the target is saved only if it succeeds); 'mcp' (an MCP server's endpoint_url, transport and sign_in: a server without sign-in is probed and saved the same way, and one that needs sign-in returns status=awaiting_user with a finish_url to show your user, then you check it once with get_pending_target when they say they are done); 'url' (a page of yours that your agent's chat lives on: a headless browser discovers the agent behind it, returning status=discovering and a discovery_token to poll with get_target_discovery, or status=not_a_page when the url is already an agent's API endpoint, then supply it as a 'config'); or 'discovery_token' (plus 'candidate' when get_target_discovery listed more than one) to save a discovered candidate, whose session stays on the server. A rejected URL or a failed probe stores nothing and returns a categorized error (invalid_url / unreachable / auth_failed / parse_error / no_reply / not_an_endpoint / unknown). This tool takes no keys, tokens or passwords: an MCP server that needs sign-in returns status=awaiting_user and a finish_url where your user finishes connecting it in the Enoki app; an agent that needs a key is added at https://app.enokilabs.ai/inventory (Add integration), which is also the fix for an auth_failed probe on an agent that needs one. Call get_setup_guide first for the workflow and the field reference. Check list_targets first (a matching name + endpoint_host in the same environment is the same target, so reuse its model_id; if only one of them matches, confirm with your user before creating). A target's connection has no update or delete over MCP; change it in the Enoki app. Its profile is read and changed with get_target_profile and update_target_profile. The response never echoes your config. Requires the write scope; the full setup flow also needs read, for get_setup_guide, list_targets and get_pending_target.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "create_target"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mcp | No | An MCP server's connection: endpoint_url, transport and sign_in. Its fields and examples are in get_setup_guide. | |
| url | No | A page of yours that your agent's chat lives on, to discover the agent behind it. | |
| name | No | Display name for the target; required with 'config', 'mcp' or 'discovery_token'. | |
| config | No | An agent endpoint's connection config (endpoint_url, response_field, transport, ...); its fields are in get_setup_guide and the create_target_schema resource. | |
| candidate | No | Index of the discovered candidate to save, when there is more than one. | |
| environment | No | Where the target runs. | staging |
| discovery_token | No | Id of the discovery job a create_target call with 'url' started. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| status | Yes | 'created' when a target was saved; 'awaiting_user' when an MCP server waits for your user to finish connecting it at finish_url; 'discovering' for a page; 'not_a_page' when the url is an agent's API endpoint, to supply as a 'config'. | |
| message | No | What to do next, when there is more. | |
| model_id | No | The target's id, when status=created. | |
| connected | No | Whether the probe read a reply. | |
| expires_at | No | When finish_url stops working (ISO 8601, UTC), when status=awaiting_user. | |
| finish_url | No | The Enoki app page where your user finishes connecting the MCP server, when status=awaiting_user. Show it to them. | |
| discovery_token | No | Poll it with get_target_discovery, when status=discovering. | |
| pending_target_id | No | Check it once with get_pending_target when your user says they are done, when status=awaiting_user. |