Morpho API MCP Server

Instructions

Implementation Reference

• src/index.ts:1189-1236 (handler)

  Handler function that executes the get_oracle_details tool by constructing a GraphQL query to fetch oracle details for a given market unique key and chain ID, validates the response, and returns the data.

  if (name === GET_ORACLE_DETAILS_TOOL) {
      try {
            const { marketUniqueKey, chainId = 1 } = params as OracleDetailsParams;
            const query = `
            query {
              marketByUniqueKey(
                uniqueKey: "${marketUniqueKey}"
                chainId: ${chainId}
              ) {
                oracle {
                  address
                  type
                  data {
                    ... on MorphoChainlinkOracleData {
                      baseFeedOne {
                        address
                        description
                        vendor
                        pair
                      }
                      vault
                    }
                    ... on MorphoChainlinkOracleV2Data {
                      baseFeedOne {
                        address
                        description
                        vendor
                        pair
                      }
                    }
                  }
                }
              }
            }`;
  
            const response = await axios.post(MORPHO_API_BASE, { query });
            const validatedData = OracleDetailsResponseSchema.parse(response.data);
  
            return {
              content: [{ type: 'text', text: JSON.stringify(validatedData.data.marketByUniqueKey, null, 2) }],
            };
      } catch (error: any) {
            return {
              isError: true,
              content: [{ type: 'text', text: `Error retrieving oracle details: ${error.message}` }],
            };
      }
  }

• src/index.ts:719-729 (registration)

  Tool registration in the ListToolsRequestSchema handler, defining the name, description, and input schema for get_oracle_details.

    name: GET_ORACLE_DETAILS_TOOL,
    description: 'Get oracle details for a specific market.',
    inputSchema: {
      type: 'object',
      properties: {
        marketUniqueKey: { type: 'string' },
        chainId: { type: 'number' }
      },
      required: ['marketUniqueKey']
    },
  },

• src/index.ts:287-293 (schema)

  Zod response schema used to validate the API response in the get_oracle_details handler.

  const OracleDetailsResponseSchema = z.object({
    data: z.object({
      marketByUniqueKey: z.object({
        oracle: OracleSchema,
      }),
    }),
  });

• src/index.ts:206-232 (schema)

  Core Zod schemas defining the Oracle, OracleData, and OracleFeed structures used in validation for get_oracle_details.

  const OracleFeedSchema = z.object({
    address: z.string(),
    description: z.string(),
    vendor: z.string(),
    pair: z.string(),
  });
  
  // Oracle Data Schema
  const OracleDataSchema = z.discriminatedUnion('type', [
    z.object({
      type: z.literal('MorphoChainlinkOracle'),
      baseFeedOne: OracleFeedSchema,
      vault: z.string(),
    }),
    z.object({
      type: z.literal('MorphoChainlinkOracleV2'),
      baseFeedOne: OracleFeedSchema,
    }),
  ]);
  
  // Oracle Schema
  const OracleSchema = z.object({
    address: z.string(),
    type: z.string(),
    data: OracleDataSchema,
  });

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

  Constant definition for the tool name used throughout the code.

  const GET_ORACLE_DETAILS_TOOL = 'get_oracle_details';