buyInPassMarket
Purchase tokens in a proposal's pass market to support its implementation on the Futarchy protocol.
Instructions
Buy tokens in the pass market for a proposal
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| proposalId | Yes | The ID of the proposal to trade in | |
| amount | Yes | Amount to buy | |
| user | Yes | User's public key |
Implementation Reference
- src/mcp/server/index.ts:328-372 (registration)Registration of the MCP 'buyInPassMarket' tool, including input schema (Zod) and handler function that delegates to the API client.server.tool( "buyInPassMarket", "Buy tokens in the pass 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.buyInPassMarket(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 pass market: ${error.message || 'Unknown error'}`, }, ], isError: true, }; } } );
- src/mcp/server/index.ts:336-371 (handler)The handler function for the 'buyInPassMarket' tool. It calls the FutarchyApiClient's buyInPassMarket method and formats the response as MCP content.async ({ proposalId, amount, user }) => { try { const response = await apiClient.buyInPassMarket(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 pass market: ${error.message || 'Unknown error'}`, }, ], isError: true, }; } }
- src/mcp/server/index.ts:331-335 (schema)Zod input schema defining parameters for the 'buyInPassMarket' tool: proposalId (string), amount (number), user (public key string).{ 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"), },
- src/mcp/common/api.ts:164-192 (helper)Helper method in FutarchyApiClient that performs the actual HTTP POST request to the backend endpoint /proposals/{proposalId}/buy-pass to execute the buy operation.async buyInPassMarket(proposalId: string, amount: number, userPublicKey: string): Promise<Response> { try { const response = await fetch(`${this.baseUrl}/proposals/${proposalId}/buy-pass`, { 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 pass market' }; } }