Futarchy MCP Server

Instructions

Implementation Reference

• src/mcp/server/index.ts:148-182 (handler)

  The asynchronous handler function for the MCP 'getProposals' tool. It calls the FutarchyApiClient.getProposals method with the provided daoId, handles the response, and returns formatted text content or an error.

  async ({ daoId }) => {
    try {
      const response = await apiClient.getProposals(daoId);
      
      if (!response.success) {
        return {
          content: [
            {
              type: "text" as const,
              text: response.error || 'Unknown error',
            },
          ],
          isError: true,
        };
      }
      
      return {
        content: [
          {
            type: "text" as const,
            text: JSON.stringify(response.data, null, 2),
          },
        ],
      };
    } catch (error: any) {
      return {
        content: [
          {
            type: "text" as const,
            text: `Error fetching proposals: ${error.message || 'Unknown error'}`,
          },
        ],
        isError: true,
      };
    }

• src/mcp/server/index.ts:142-184 (registration)

  Registration of the 'getProposals' MCP tool using McpServer.tool(), including the tool name, description, input schema (daoId), and handler reference.

  server.tool(
    "getProposals",
    "Get all proposals for a specific DAO",
    {
      daoId: z.string().describe("The ID of the DAO to get proposals for"),
    },
    async ({ daoId }) => {
      try {
        const response = await apiClient.getProposals(daoId);
        
        if (!response.success) {
          return {
            content: [
              {
                type: "text" as const,
                text: response.error || 'Unknown error',
              },
            ],
            isError: true,
          };
        }
        
        return {
          content: [
            {
              type: "text" as const,
              text: JSON.stringify(response.data, null, 2),
            },
          ],
        };
      } catch (error: any) {
        return {
          content: [
            {
              type: "text" as const,
              text: `Error fetching proposals: ${error.message || 'Unknown error'}`,
            },
          ],
          isError: true,
        };
      }
    }
  );

• src/mcp/common/types.ts:63-65 (schema)

  Zod schema definition for the input parameters of getProposals (GetProposalsParamsSchema), matching the inline schema used in registration.

  export const GetProposalsParamsSchema = z.object({
    daoId: z.string().describe("The ID of the DAO to get proposals for"),
  });

• src/mcp/common/api.ts:56-73 (helper)

  Helper function in FutarchyApiClient that performs the actual HTTP fetch to retrieve proposals for a given DAO ID from the backend API.

  async getProposals(daoId: string): Promise<Response> {
    try {
      const response = await fetch(`${this.baseUrl}/daos/${daoId}/proposals`);
      if (!response.ok) {
        throw new Error(`HTTP error! Status: ${response.status}`);
      }
      const data = await response.json();
      
      return {
        success: true,
        data: data.proposals
      };
    } catch (error: any) {
      return {
        success: false,
        error: error.message || `Failed to fetch proposals for DAO: ${daoId}`
      };
    }