home / mcp / ibex 35 mcp server

IBEX 35 MCP Server

A free MCP server that allows querying a curated database of public data about the 35 most relevant companies in the Spanish stock exchange (IBEX35)

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "anbrme-ibex35-mcp-server": {
      "command": "ibex35-mcp",
      "args": [],
      "env": {
        "IBEX35_API_KEY": "YOUR_API_KEY",
        "IBEX35_API_URL": "https://ibex35-api.ncdata.eu"
      }
    }
  }
}

You can run the IBEX 35 MCP Server to give Claude and other MCP-compatible clients access to up-to-date IBEX 35 data, corporate governance insights, and financial analytics. It enables real-time market data, governance analysis, shareholder intelligence, risk assessment, and advanced analytics for financial research and corporate investigations on the Spanish market.

How to use

Connect your MCP client to the IBEX 35 MCP Server to start asking questions about IBEX 35 data, governance structures, and market analytics. You will run the server locally or remotely, then configure your client (for example Claude Desktop) to point at the MCP server. Once connected, you can query for current prices, historical OHLCV data, board directors, ownership structures, governance risk, and sentiment about IBEX 35 companies. Use natural language or structured queries to compare companies, analyze governance networks, and screen investment opportunities.

How to install

Prerequisites: Node.js 18+ and an MCP-compatible client (such as Claude Desktop). Follow one of the installation paths below.

# Prerequisite: ensure Node.js is installed
node --version

# Option 1: NPM Global Install (Recommended)
npm install -g ibex35-mcp-server

# Option 2: From Source
git clone https://github.com/anbrme/ibex35-mcp-server.git
cd ibex35-mcp-server
npm install
npm run build

Configuration and usage notes

Configure how you connect to data sources and run the MCP server. The server uses a Cloudflare Worker-based API to access the underlying D1 database. You can override the API URL and provide an optional API key if your setup requires it.

{
  "mcpServers": {
    "ibex35-database": {
      "command": "ibex35-mcp",
      "env": {
        "IBEX35_API_URL": "https://ibex35-api.ncdata.eu"
      }
    }
  }
}

{
  "mcpServers": {
    "ibex35-database": {
      "command": "node",
      "args": ["/path/to/ibex35-mcp-server/dist/index.js"],
      "env": {
        "IBEX35_API_URL": "https://ibex35-api.ncdata.eu"
      }
    }
  }
}

Start and connect

1. Start Claude Desktop and ensure it fully restarts after you make configuration changes. 2. Create a new conversation in Claude Desktop and select the IBEX 35 MCP Server as the data source. 3. Begin asking questions about current IBEX 35 prices, historical data, governance structures, and market analytics.

Security

The MCP server provides read-only access to data. Only SELECT-like operations are allowed for custom queries, and all parameters are validated and sanitized. No destructive actions are possible through the MCP interface.

Troubleshooting

If Claude doesn’t recognize the server, ensure the configuration JSON is valid and that the MCP service is running. Restart Claude Desktop and verify Node.js 18+ is installed. If connectivity to data sources fails, verify the IBEX 35 API URL and network access.

Data sources

Data originates from authoritative Spanish sources including the Madrid Stock Exchange, CNMV, EU Transparency Register, corporate websites, and financial news outlets.

Notes for developers

The server is designed to be integrated with the Claude Desktop workflow and other MCP clients. Maintain compatibility with the underlying data schema and synchronization processes when extending features.

Available tools

get_all_companies

List all IBEX 35 companies with current data

get_company_by_symbol

Detailed information for a specific IBEX 35 company by its symbol

get_companies_by_sector

Filter IBEX 35 companies by sector

get_companies_with_pe_ratio

Filter companies by P/E ratio range

get_company_directors

Board directors for a company

get_board_interlocks

Directors serving on multiple boards

get_directors_by_name

Search directors across all IBEX 35 companies

get_company_shareholders

Shareholder structure for a company

get_shareholder_overlap

Shareholders with stakes in multiple IBEX 35 companies

get_top_shareholders_by_sector

Top shareholders by sector

get_historical_prices

Historical OHLCV data

get_top_performers

Best/worst performers over a period

get_recent_news

get_news_by_sentiment

Filter news by sentiment (positive/negative/neutral)

get_lobbying_meetings

EU lobbying meetings and activities

get_most_active_lobbyists

Organizations with most lobbying activity

get_network_analysis

Complete network analysis of governance relationships

get_sector_correlation_analysis

Sector performance correlation analysis

analyze_natural_query

Process complex natural language queries with intelligent routing

compare_companies

Multi-dimensional company comparison (financial, governance, performance)

analyze_trends

Advanced trend analysis with forecasting (company, sector, market, correlation)

assess_investment_risk

Comprehensive risk assessment (market, governance, sector, liquidity, concentration)

generate_analyst_report

Professional analyst reports (company deep-dive, sector overview, governance analysis)

screen_opportunities

Investment opportunity screening with custom criteria and scoring

get_weekly_reports

Generated weekly market and governance reports

get_esg_scores

ESG scores and sustainability metrics

execute_custom_query

Execute custom SQL queries (SELECT only)