execute_agent
Activate a specific AI agent on DollhouseMCP to achieve a defined goal by executing the desired persona and task.
Instructions
Execute an agent element with a specific goal
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| goal | Yes | The goal for the agent to achieve | |
| name | Yes | The agent name to execute |
Implementation Reference
- TypeScript interface defining the input arguments for the execute_agent tool.interface ExecuteAgentArgs { name: string; goal: string; }
- src/server/tools/ElementTools.ts:221-240 (handler)MCP tool definition, schema, and handler implementation for 'execute_agent'. The handler delegates to server.executeAgent(name, goal).tool: { name: "execute_agent", description: "Execute an agent element with a specific goal", inputSchema: { type: "object", properties: { name: { type: "string", description: "The agent name to execute", }, goal: { type: "string", description: "The goal for the agent to achieve", }, }, required: ["name", "goal"], }, }, handler: (args: ExecuteAgentArgs) => server.executeAgent(args.name, args.goal) },
- src/server/ServerSetup.ts:52-54 (registration)Registers all element tools, including the execute_agent tool, with the MCP tool registry during server setup.// Register element tools (new generic tools for all element types) this.toolRegistry.registerMany(getElementTools(instance));
- src/server/types.ts:31-31 (schema)Interface declaration for the underlying server.executeAgent method called by the tool handler.executeAgent(name: string, goal: string): Promise<any>;