sellInFailMarket

Execute token sales in the fail market for specific proposals on the Solana-based Futarchy protocol, enabling users to manage DAO trading positions.

Instructions

Sell tokens in the fail market for a proposal

Input Schema

TableJSON Schema

Name	Required	Description
`proposalId`	Yes	The ID of the proposal to trade in
`amount`	Yes	Amount to sell
`user`	Yes	User's public key

Implementation Reference

src/mcp/server/index.ts:474-509 (handler)

The handler function that executes the sellInFailMarket MCP tool. It calls the FutarchyApiClient.sellInFailMarket method and formats the response as MCP content or error.

async ({ proposalId, amount, user }) => {
  try {
    const response = await apiClient.sellInFailMarket(proposalId, amount, user);
    
    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 selling in fail market: ${error.message || 'Unknown error'}`,
        },
      ],
      isError: true,
    };
  }
}

src/mcp/server/index.ts:466-510 (registration)

The registration of the sellInFailMarket tool on the MCP server, including name, description, input schema, and handler reference.

server.tool(
  "sellInFailMarket",
  "Sell tokens in the fail market for a proposal",
  {
    proposalId: z.string().describe("The ID of the proposal to trade in"),
    amount: z.number().describe("Amount to sell"),
    user: z.string().describe("User's public key"),
  },
  async ({ proposalId, amount, user }) => {
    try {
      const response = await apiClient.sellInFailMarket(proposalId, amount, user);
      
      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 selling in fail market: ${error.message || 'Unknown error'}`,
          },
        ],
        isError: true,
      };
    }
  }
);

src/mcp/server/index.ts:469-473 (schema)

Zod input schema for the sellInFailMarket tool parameters.

{
  proposalId: z.string().describe("The ID of the proposal to trade in"),
  amount: z.number().describe("Amount to sell"),
  user: z.string().describe("User's public key"),
},

src/mcp/common/api.ts:254-282 (helper)

Helper function in FutarchyApiClient that makes HTTP POST request to the backend API to sell tokens in the fail market.

async sellInFailMarket(proposalId: string, amount: number, userPublicKey: string): Promise<Response> {
  try {
    const response = await fetch(`${this.baseUrl}/proposals/${proposalId}/sell-fail`, {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
      },
      body: JSON.stringify({
        amount,
        user: userPublicKey
      })
    });

    if (!response.ok) {
      throw new Error(`HTTP error! Status: ${response.status}`);
    }
    const data = await response.json();
    
    return {
      success: true,
      data: data
    };
  } catch (error: any) {
    return {
      success: false,
      error: error.message || 'Failed to sell in fail market'
    };
  }
}

Futarchy MCP Server