get_proposal_directories
Retrieve all proposal directories organized by status categories including edit, open, won, lost, and closed for efficient proposal management.
Instructions
Get all proposal directories grouped by status (edit, open, won, lost, closed)
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Input Schema (JSON Schema)
{
"properties": {},
"type": "object"
}
Implementation Reference
- Full tool definition including the 'execute' handler function that fetches proposal directories from the API endpoint '/proposal-directories/', parses and validates the response using proposalDirectoriesSchema, and returns the stringified data.export const getProposalDirectoriesTool: Tool<undefined, typeof parameters> = { name: 'get_proposal_directories', description: 'Get all proposal directories grouped by status (edit, open, won, lost, closed)', parameters, annotations: { title: 'Get Proposal Directories', openWorldHint: true, }, async execute() { const result = await get('/proposal-directories/'); const parsed = proposalDirectoriesSchema.safeParse(result); if (!parsed.success) { throwApiInvalidResponseError(parsed.error); } return JSON.stringify(parsed.data); }, };
- src/schemas/proposals.ts:30-41 (schema)Zod schema definitions for proposalDirectorySchema (used within proposalDirectoriesSchema) and proposalDirectoriesSchema for validating the API response structure grouped by status.export const proposalDirectorySchema = z.object({ id: z.number(), name: z.string(), }); export const proposalDirectoriesSchema = z.object({ closed: z.array(proposalDirectorySchema).optional(), edit: z.array(proposalDirectorySchema).optional(), lost: z.array(proposalDirectorySchema).optional(), open: z.array(proposalDirectorySchema).optional(), won: z.array(proposalDirectorySchema).optional(), });
- src/tools/register.ts:19-39 (registration)Imports and includes getProposalDirectoriesTool in the tools array, then registers all tools to the FastMCP server instance using addTool after applying initialContextGuard.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)); }