buyInFailMarket
Purchase tokens in the fail market for a specific proposal on the Futarchy MCP Server. Input the proposal ID, amount to buy, and user’s public key to execute the trade.
Instructions
Buy tokens in the fail market for a proposal
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| amount | Yes | Amount to buy | |
| proposalId | Yes | The ID of the proposal to trade in | |
| user | Yes | User's public key |
Implementation Reference
- src/mcp/server/index.ts:420-464 (registration)MCP server tool registration for 'buyInFailMarket', including input schema (Zod) and handler function that calls apiClient.buyInFailMarket and formats the MCP response.server.tool( "buyInFailMarket", "Buy 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 buy"), user: z.string().describe("User's public key"), }, async ({ proposalId, amount, user }) => { try { const response = await apiClient.buyInFailMarket(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 buying in fail market: ${error.message || 'Unknown error'}`, }, ], isError: true, }; } } );
- src/mcp/common/api.ts:224-252 (handler)The core helper function in FutarchyApiClient that implements the buyInFailMarket logic by proxying an HTTP POST request to the backend endpoint /proposals/{proposalId}/buy-fail.async buyInFailMarket(proposalId: string, amount: number, userPublicKey: string): Promise<Response> { try { const response = await fetch(`${this.baseUrl}/proposals/${proposalId}/buy-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 buy in fail market' }; } }
- src/mcp/server/index.ts:423-427 (schema)Input schema definition using Zod for the buyInFailMarket tool parameters.{ proposalId: z.string().describe("The ID of the proposal to trade in"), amount: z.number().describe("Amount to buy"), user: z.string().describe("User's public key"), },