ibex35-mcp

Instructions

Implementation Reference

• src/database.ts:138-151 (handler)

  Core handler function that implements the tool logic: fetches shareholder positions from the API endpoint '/api/shareholder-positions', resolves the company symbol from company ID, and filters shareholders matching the company's symbol.

  async getCompanyShareholders(companyId: string): Promise<any[]> {
    const data = await this.fetchAPI('/api/shareholder-positions');
    const shareholders = data.shareholderPositions || data.positions || [];
    
    // Find company by ID first to get symbol
    const companies = await this.getAllCompanies();
    const company = companies.find(c => c.id === companyId);
    if (!company) return [];
  
    return shareholders.filter(position => 
      position.company_symbol === company.symbol || 
      position.ticker === company.symbol
    );
  }

• src/index.ts:144-157 (registration)

  Tool registration in the listTools handler, defining the tool name, description, and input schema.

  {
    name: 'get_company_shareholders',
    description: 'Get shareholders for a specific company',
    inputSchema: {
      type: 'object',
      properties: {
        companyId: {
          type: 'string',
          description: 'Company ID',
        },
      },
      required: ['companyId'],
    },
  },

• src/index.ts:605-607 (handler)

  Dispatch handler in the CallToolRequestSchema that invokes the database method with the provided companyId argument.

  case 'get_company_shareholders':
    result = await this.db.getCompanyShareholders((args as any)?.companyId);
    break;