Offorte Proposal Software

Instructions

Implementation Reference

• src/tools/context/get-initial-context.ts:7-31 (handler)

  The primary handler for the 'get_initial_context' tool. Defines the tool object with name, description, empty parameters, annotations, and the execute function that constructs and returns the initial context string including instructions, account name, and current date.
  export const getInitialContextTool: Tool<undefined, typeof parameters> = { name: 'get_initial_context', description: `IMPORTANT: This tool must be called before using any other tools. It will get usage instructions & Offorte context for this MCP server.`, parameters, annotations: { title: 'Get MCP Server Instructions', openWorldHint: false, }, async execute() { const currentDate = new Date().toLocaleDateString('en-US'); const context = outdent` ${INSTRUCTIONS} Context for your Offorte instance: <context> Account Name: ${config.accountName} Date today: ${currentDate} </content> `; return context; }, };
• src/utils/schema.ts:3-3 (schema)

  Zod schema definition for empty object parameters, aliased as 'parameters' and used in the get_initial_context tool.
  export const emptyObject = z.object({});
• src/tools/register.ts:19-39 (registration)

  Registers the getInitialContextTool (imported earlier at line 3) by including it in the tools array and adding all tools to the FastMCP server instance with the initialContextGuard wrapper.
  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)); }
• src/tools/context/initial-context-guard.ts:6-25 (helper)

  Helper function that wraps tool execute methods to enforce calling 'get_initial_context' first before other tools, setting a flag upon its execution.
  export function initialContextGuard(tool: FastMCPTool<any, ToolParameters>): typeof tool { if (tool.name === 'get_initial_context') { return { ...tool, execute: async (args: any, context: Context<any>) => { initialContextSet = true; return tool.execute(args, context); }, }; } return { ...tool, execute: async (args: any, context: Context<any>) => { if (!initialContextSet) { throw new Error('Initial context has not been set. You must call get_initial_context before using this tool.'); } return tool.execute(args, context); }, }; }