IDA Pro MCP Server

Instructions

Implementation Reference

• idaremoteclient.ts:498-516 (handler)

  The core handler function getXrefsFrom in IDARemoteClient that performs HTTP GET request to IDA Pro remote server endpoint /xrefs/from to retrieve cross-references from the given address.

  async getXrefsFrom(
      address: number | string,
      options: {
          type?: 'code' | 'data' | 'all';
      } = {}
  ): Promise<XrefsResponse> {
      const params = new URLSearchParams();
      
      const addr = typeof address === 'string'
          ? address
          : address.toString();
      params.append('address', addr);
      
      if (options.type !== undefined) {
          params.append('type', options.type);
      }
      
      return this.get<XrefsResponse>(`/xrefs/from?${params.toString()}`);
  }

• index.ts:816-850 (handler)

  MCP server tool handler for 'get_xrefs_from': validates arguments, calls ida.getXrefsFrom, formats and returns the result.

  case 'get_xrefs_from':
      if (!isValidGetXrefsFromArgs(request.params.arguments)) {
          throw new McpError(
              ErrorCode.InvalidParams,
              'Invalid get xrefs from arguments'
          );
      }
  
      try {
          const { address, type } = request.params.arguments;
  
          const result = await ida.getXrefsFrom(address, {
              type: type as 'code' | 'data' | 'all'
          });
  
          return {
              content: [
                  {
                      type: 'text',
                      text: `Found ${result.count} references from ${result.address} (${result.name}):\n\n${JSON.stringify(result.xrefs, null, 2)
                          }`,
                  },
              ],
          };
      } catch (error: any) {
          return {
              content: [
                  {
                      type: 'text',
                      text: `Error getting xrefs from address: ${error.message || error}`,
                  },
              ],
              isError: true,
          };
      }

• index.ts:72-75 (schema)

  TypeScript interface defining the input arguments for get_xrefs_from tool.

  interface GetXrefsFromArgs {
      address: string | number;
      type?: 'code' | 'data' | 'all';
  }

• index.ts:391-407 (registration)

  Tool registration in ListTools response, including name, description, and input schema.

      name: 'get_xrefs_from',
      description: 'Get cross-references from an address',
      inputSchema: {
          type: 'object',
          properties: {
              address: {
                  type: 'string',
                  description: 'Source address to find references from',
              },
              type: {
                  type: 'string',
                  description: 'Type of references to find (code, data, all)',
              },
          },
          required: ['address'],
      },
  },

• index.ts:145-151 (helper)

  Validation helper function to check if arguments match GetXrefsFromArgs interface.

  const isValidGetXrefsFromArgs = (args: any): args is GetXrefsFromArgs => {
      return (
          typeof args === 'object' &&
          args !== null &&
          (typeof args.address === 'string' || typeof args.address === 'number')
      );
  };