get_top_shareholders_by_sector

Identify key investors in a specific sector of the Spanish stock exchange by retrieving top shareholders for sector analysis and investment research.

Instructions

Get top shareholders in a specific sector

Input Schema

TableJSON Schema

Name	Required	Description	Default
`sector`	Yes	Sector name
`limit`	No	Maximum number of results

Implementation Reference

src/database.ts:153-166 (handler)

Core handler function that implements the tool logic: fetches companies in the sector, retrieves all shareholder positions, filters to sector companies, sorts by ownership percentage descending, and limits results.

async getTopShareholdersBySector(sector: string, limit: number = 10): Promise<any[]> {
  const companies = await this.getCompaniesBySector(sector);
  const data = await this.fetchAPI('/api/shareholder-positions');
  const shareholders = data.shareholderPositions || data.positions || [];
  
  const sectorSymbols = companies.map(c => c.symbol);
  const sectorShareholders = shareholders.filter(position =>
    sectorSymbols.includes(position.company_symbol || position.ticker)
  );

  return sectorShareholders
    .sort((a, b) => (b.percentage || 0) - (a.percentage || 0))
    .slice(0, limit);
}

src/index.ts:166-184 (registration)

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

{
  name: 'get_top_shareholders_by_sector',
  description: 'Get top shareholders in a specific sector',
  inputSchema: {
    type: 'object',
    properties: {
      sector: {
        type: 'string',
        description: 'Sector name',
      },
      limit: {
        type: 'number',
        description: 'Maximum number of results',
        default: 10,
      },
    },
    required: ['sector'],
  },
},

src/index.ts:613-615 (handler)

Dispatch handler in the CallToolRequestSchema switch statement that invokes the database method with parsed arguments.

case 'get_top_shareholders_by_sector':
  result = await this.db.getTopShareholdersBySector((args as any)?.sector, (args as any)?.limit || 10);
  break;

src/index.ts:169-182 (schema)

Input schema defining parameters: sector (required string), limit (optional number, default 10).

inputSchema: {
  type: 'object',
  properties: {
    sector: {
      type: 'string',
      description: 'Sector name',
    },
    limit: {
      type: 'number',
      description: 'Maximum number of results',
      default: 10,
    },
  },
  required: ['sector'],

ibex35-mcp