MCP Server for AI Assistants

Connect your AI assistant directly to the BizList.gr business database. Search 2.5M+ Greek companies, analyze financials, export leads - all through natural language conversation.

What is MCP?

The Model Context Protocol (MCP) is an open standard that allows AI assistants to connect to external tools and data sources. Instead of copy-pasting data, your AI can directly search companies, look up financial data, and perform analysis through BizList.gr.

MCP is supported by:

Claude Desktop (Anthropic)
Claude Code (CLI)
Cursor, Windsurf, and other AI-enabled editors
Any MCP-compatible client

Getting Started

You need a BizList.gr account with an API key:

Create an account or log in to bizlist.gr
Go to your Account page
Scroll to "API Keys" and create a new key
Copy the key immediately (it won't be shown again)
Purchase API credits to use with MCP tools

Important: Each MCP tool call consumes 1 API credit. AI analysis and lead exports consume additional credits. Check the Credits section for details.

Configuration

Claude Desktop

Add the following to your Claude Desktop configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "bizlist": {
      "type": "streamable-http",
      "url": "https://api.bizlist.gr/mcp/v1",
      "headers": {
        "X-Api-Key": "YOUR_API_KEY_HERE"
      }
    }
  }
}

Claude Code (CLI)

Run this command in your terminal:

claude mcp add-json bizlist '{
  "type": "http",
  "url": "https://api.bizlist.gr/mcp/v1",
  "headers": {
    "X-Api-Key": "YOUR_API_KEY_HERE"
  }
}' --scope user

Cursor / Other MCP Clients

Use these connection details:

URL	`https://api.bizlist.gr/mcp/v1`
Transport	Streamable HTTP
Auth Header	`X-Api-Key: YOUR_API_KEY`

Available Tools

The MCP server exposes 10 tools that your AI assistant can use:

search_companies

Advanced search with filters for activities (KAD/NACE codes), location, legal type, status, GPS radius, and more. Returns up to 25 results (unlimited for premium).

Key Parameters

`query`	Free text search
`activities`	KAD/NACE activity codes
`cities`	Filter by city
`has_email`	Only companies with email
`status`	"active", "inactive", or "all"
`gps_center_lat/lon/radius_km`	GPS radius search

get_company

Full company profile by registry number (AR GEMH). Returns activities, people, documents, financials, contact info, and related companies.

get_company_by_vat

Look up a company by VAT number. Supports Greek and EU VAT formats.

search_activities

Search KAD/NACE activity codes by keyword. Use this to find the right code before searching companies.

get_person

Get person details and all companies they are associated with (shareholder, CEO, board member, etc.).

get_credits

Check your remaining AI, lead, and API credits.

check_financial_analysis

Check the AI credit cost before running financial analysis. Always called automatically before analyze_financials.

analyze_financials

AI-powered analysis of published balance sheets. Extracts revenue, profit, assets, liabilities. Costs 1 AI credit per year analyzed.

check_export_leads

Check the lead credit cost before exporting. Returns exportable count and cost estimate.

export_leads

Export company contact data (emails, phones). Costs 1 lead credit per company with valid email.

Credits & Pricing

MCP tool calls use the same credit system as the REST API:

Action	Cost
Any tool call (search, get company, etc.)	1 API credit
AI financial analysis	1 API credit + 1 AI credit per year
Lead export	1 API credit + 1 lead credit per company
Check credits / Search activities	Free

Purchase credits on the Credits page.

Usage Examples

Once configured, just ask your AI assistant naturally:

Market Research

"I want to open a souvlaki shop on Ermou Street in Athens.
What competition do I have? How many restaurants are
in the area and what are their financials?"

Lead Generation

"Find all active software companies in Thessaloniki
that have an email address. I need their contact details."

Company Research

"Look up the company with VAT EL123456789.
Who are the shareholders? What is their revenue trend?"

Financial Analysis

"Analyze the financial documents of company 170000000000
for the last 3 years. Compare revenue and profitability."

Need Help?

If you have questions about the MCP server, contact us.

For REST API documentation, see API Docs.