Offorte Proposal Software

Instructions

Implementation Reference

• src/tools/automations/get-automation-sets.ts:7-25 (handler)

  Implements the 'get_automation_sets' tool handler. The execute function fetches data from '/automations/sets', validates it using automationSetsSchema, and returns the JSON string of the parsed data.

  export const getAutomationSetsTool: Tool<undefined, typeof parameters> = {
  	name: 'get_automation_sets',
  	description: 'Lists automation sets which are used as an optional input to create a new proposal',
  	parameters,
  	annotations: {
  		title: 'Get Automation Sets',
  		openWorldHint: true,
  	},
  	async execute() {
  		const result = await get('/automations/sets');
  		const parsed = automationSetsSchema.safeParse(result);
  
  		if (!parsed.success) {
  			throwApiInvalidResponseError(parsed.error);
  		}
  
  		return JSON.stringify(parsed.data);
  	},
  };

• src/schemas/automations.ts:3-10 (schema)

  Defines the Zod schemas for automation sets: automationSetSchema (object with id and name) and automationSetsSchema (array of automationSetSchema), used for output validation in the get_automation_sets tool.

  export const automationSetSchema = z
  	.object({
  		id: z.number(),
  		name: z.string(),
  	})
  	.passthrough();
  
  export const automationSetsSchema = z.array(automationSetSchema);

• src/tools/register.ts:19-39 (registration)

  Registers the getAutomationSetsTool by including it in the tools array and adding all tools to the FastMCP server in the registerTools function.

  const tools = [
  	getInitialContextTool,
  	getAccountUsersTool,
  	getAutomationSetsTool,
  	getContactDetailsTool,
  	getDesignTemplatesTool,
  	getEmailTemplatesTool,
  	getProposalDirectoriesTool,
  	getProposalTemplatesTool,
  	getTextTemplatesTool,
  	searchContactOrganisationsTool,
  	searchContactPeopleTool,
  	searchProposalsTool,
  	createContactTool,
  	createProposalTool,
  	sendProposalTool,
  ];
  
  export function registerTools({ server }: { server: FastMCP }) {
  	(tools as unknown as FastMCPTool<Record<string, unknown>, ToolParameters>[]).map(initialContextGuard).forEach((tool) => server.addTool(tool));
  }