MCP Jupiter

Instructions

Input Schema

Input Schema (JSON Schema)

Implementation Reference

• src/handlers/jupiter.ts:70-123 (handler)

  Core handler function that implements the jupiter_build_swap_transaction tool. Validates user public key, parses quoteResponse JSON, builds POST request to Jupiter's /swap-instructions endpoint, fetches and returns the swap transaction data or error response.
  export const buildSwapTransactionHandler = async (input: BuildSwapTransactionInput): Promise<ToolResultSchema> => { try { // Validate user public key const userPublicKeyResult = validatePublicKey(input.userPublicKey); if (!(userPublicKeyResult instanceof PublicKey)) { return userPublicKeyResult; } // Parse the quote response let quoteResponse; try { quoteResponse = JSON.parse(input.quoteResponse); } catch (error) { return createErrorResponse(`Invalid quote response: ${error instanceof Error ? error.message : String(error)}`); } // Build the request body const requestBody: any = { quoteResponse, userPublicKey: input.userPublicKey }; if (input.prioritizationFeeLamports !== undefined) { requestBody.prioritizationFeeLamports = input.prioritizationFeeLamports; } if (input.computeUnitPriceMicroLamports !== undefined) { requestBody.computeUnitPriceMicroLamports = input.computeUnitPriceMicroLamports; } if (input.asLegacyTransaction !== undefined) { requestBody.asLegacyTransaction = input.asLegacyTransaction; } // Make the API request const response = await fetch(`${JUPITER_API_BASE_URL}/swap-instructions`, { method: "POST", headers: { "Content-Type": "application/json" }, body: JSON.stringify(requestBody) }); if (!response.ok) { const errorText = await response.text(); return createErrorResponse(`Error building swap transaction: ${response.status} ${response.statusText} - ${errorText}`); } const swapData = await response.json(); return createSuccessResponse(`Swap transaction: ${JSON.stringify(swapData, null, 2)}`); } catch (error) { return createErrorResponse(`Error building swap transaction: ${error instanceof Error ? error.message : String(error)}`); } };
• src/tools.ts:27-41 (schema)

  Input schema definition for the jupiter_build_swap_transaction tool, specifying properties and required fields matching the handler input.
  { name: "jupiter_build_swap_transaction", description: "Build a swap transaction on Jupiter", inputSchema: { type: "object", properties: { quoteResponse: { type: "string" }, userPublicKey: { type: "string" }, prioritizationFeeLamports: { type: "number" }, computeUnitPriceMicroLamports: { type: "number" }, asLegacyTransaction: { type: "boolean" } }, required: ["quoteResponse", "userPublicKey"] } },
• src/tools.ts:59-63 (registration)

  Registration of the handler function for 'jupiter_build_swap_transaction' in the handlers dictionary, mapping tool name to buildSwapTransactionHandler.
  export const handlers: handlerDictionary = { "jupiter_get_quote": getQuoteHandler, "jupiter_build_swap_transaction": buildSwapTransactionHandler, "jupiter_send_swap_transaction": sendSwapTransactionHandler };
• src/handlers/jupiter.types.ts:14-20 (schema)

  TypeScript interface defining the input shape for buildSwapTransactionHandler, used for type safety in the handler.
  export interface BuildSwapTransactionInput { quoteResponse: string; userPublicKey: string; prioritizationFeeLamports?: number; computeUnitPriceMicroLamports?: number; asLegacyTransaction?: boolean; }
• src/handlers/utils.ts:53-59 (helper)

  Helper function validatePublicKey used in the handler to validate the userPublicKey input and return error response if invalid.
  export const validatePublicKey = (publicKeyString: string): PublicKey | ToolResultSchema => { const { publicKey, error } = createPublicKey(publicKeyString); if (error) { return createErrorResponse(error); } return publicKey!; };