Aster Finance MCP Server

Instructions

Implementation Reference

• src/index.ts:623-624 (handler)

  The handler for the 'getMultiAssetsMode' tool. It invokes the shared makeRequest helper to perform a signed GET request to the Aster futures API endpoint '/fapi/v1/multiAssetsMargin' with the provided arguments (none required).

  case 'getMultiAssetsMode':
      return makeRequest('GET', '/fapi/v1/multiAssetsMargin', args, true);

• src/index.ts:239-239 (registration)

  Registration of the 'getMultiAssetsMode' tool in the tools list provided by the ListToolsRequestSchema handler, including its name, description, and input schema.

  { name: 'getMultiAssetsMode', description: "Get user's Multi-Assets mode.", inputSchema: { type: 'object', properties: {} } },

• src/index.ts:239-239 (schema)

  Input schema for 'getMultiAssetsMode': an empty object (no parameters required).

  { name: 'getMultiAssetsMode', description: "Get user's Multi-Assets mode.", inputSchema: { type: 'object', properties: {} } },

• src/index.ts:542-579 (helper)

  Shared helper function 'makeRequest' used by all signed tool handlers, including 'getMultiAssetsMode'. It constructs and signs the API request using API_KEY and API_SECRET, makes the axios request, and formats the response as MCP content.

  const makeRequest = async (method: 'GET' | 'POST' | 'DELETE', path: string, params: any, isSigned = false) => {
    try {
      let config: any = {
        method,
        url: path,
      };
  
      if (isSigned) {
        if (!API_KEY || !API_SECRET) {
          throw new McpError(ErrorCode.InvalidRequest, 'API_KEY and API_SECRET must be configured.');
        }
        params.timestamp = Date.now();
        const queryString = new URLSearchParams(params).toString();
        const signature = crypto.createHmac('sha256', API_SECRET).update(queryString).digest('hex');
        params.signature = signature;
        
        config.headers = { 'X-MBX-APIKEY': API_KEY };
      }
      
      if (method === 'GET' || method === 'DELETE') {
        config.params = params;
      } else { // POST
        config.data = new URLSearchParams(params).toString();
        config.headers = { ...config.headers, 'Content-Type': 'application/x-www-form-urlencoded' };
      }
  
      const response = await this.axiosInstance.request(config);
      return { content: [{ type: 'text', text: JSON.stringify(response.data, null, 2) }] };
    } catch (error) {
      if (axios.isAxiosError(error)) {
        throw new McpError(
          ErrorCode.InternalError,
          `Aster API error: ${error.response?.data?.msg || error.message}`
        );
      }
      throw error;
    }
  };