BizList.gr MCP Server

Συνδέει AI agents απευθείας με τη βάση δεδομένων ελληνικών επιχειρήσεων του BizList.gr. Αναζήτηση 1.1M+ εταιρειών, μέτοχοι και διοίκηση, ανάλυση δημοσιευμένων οικονομικών, εξαγωγή επαληθευμένων leads, από οποιονδήποτε MCP-compatible AI assistant.

Server URL	`https://api.bizlist.gr/mcp/v1`
Transport	Streamable HTTP
Authentication	OAuth 2.1 + PKCE (με Dynamic Client Registration), ή X-Api-Key
Protocol	Model Context Protocol

Τι είναι το MCP;

Το Model Context Protocol (MCP) είναι ένα ανοιχτό πρότυπο που επιτρέπει σε AI agents να συνδέονται με εξωτερικά εργαλεία και πηγές δεδομένων. Αντί να κάνετε copy-paste δεδομένα, το AI σας μπορεί απευθείας να αναζητά εταιρείες, να βλέπει οικονομικά στοιχεία και να κάνει ανάλυση μέσω του BizList.gr.

Ο BizList MCP server δουλεύει με κάθε MCP-compatible client, συμπεριλαμβανομένων:

claude.ai (Web, Desktop, Mobile), μέσω OAuth, χωρίς API key
Claude Code (CLI)
Cursor, Windsurf και άλλους AI-enabled editors
Custom agents φτιαγμένοι με OpenAI Agents SDK, Anthropic SDK, LangGraph, κ.ά.
Κάθε άλλο MCP client με Streamable HTTP transport

Γρήγορη σύνδεση μέσω OAuth

Κάθε MCP client που υποστηρίζει OAuth 2.1 μπορεί να συνδεθεί χωρίς ρυθμίσεις. Χωρίς API key, χωρίς manual setup. Ο server δημοσιεύει το OAuth metadata στο /.well-known/oauth-authorization-server και υποστηρίζει Dynamic Client Registration (RFC 7591), οπότε ο client καταχωρεί τον εαυτό του αυτόματα την πρώτη φορά.

Παράδειγμα: claude.ai

Ανοίξτε το claude.ai
Πηγαίνετε στο Settings → Connectors → Add custom connector
Επικολλήστε το URL: https://api.bizlist.gr/mcp/v1
Πατήστε Connect
Θα ανακατευθυνθείτε στο bizlist.gr για σύνδεση και έγκριση πρόσβασης
Έτοιμο. Όλα τα εργαλεία διαθέσιμα στις συνομιλίες σας

Άλλοι OAuth-capable clients

Δώστε στο client το URL https://api.bizlist.gr/mcp/v1. Στο πρώτο request θα λάβει 401 με WWW-Authenticate header που δείχνει στο resource metadata. Από εκεί ο client ακολουθεί την standard ροή OAuth 2.1 + PKCE ενώντας στον discovered authorization server. Δεν χρειάζεται προ-καταχώρηση client.

Πώς δουλεύει το authorization: Το bizlist.gr είναι ο OAuth 2.1 provider. Όταν συνδέεται ένας client, ο user ανακατευθύνεται στο bizlist.gr για σύνδεση και ρητή έγκριση των capabilities (αναζήτηση, ανάλυση οικονομικών, εξαγωγή leads) που μπορεί να χρησιμοποιεί ο agent. Η πρόσβαση μπορεί να ανακληθεί οποτεδήποτε από τη σελίδα Λογαριασμός ή από τις ρυθμίσεις του client.

Ρύθμιση με API key

Για programmatic clients που δεν υποστηρίζουν OAuth flow (background jobs, scripts, αρχεία ρυθμίσεων του Claude Desktop κ.λπ.), χρησιμοποιήστε ένα long-lived API key:

Δημιουργήστε λογαριασμό ή συνδεθείτε στο bizlist.gr
Πηγαίνετε στη σελίδα Λογαριασμός
Μεταβείτε στα "API Keys" και δημιουργήστε ένα νέο κλειδί
Αντιγράψτε το κλειδί αμέσως (δεν θα εμφανιστεί ξανά)
Αγοράστε API credits για χρήση με τα MCP εργαλεία

Σημαντικό: Κάθε κλήση εργαλείου MCP καταναλώνει 1 API credit. Η AI ανάλυση και η εξαγωγή leads καταναλώνουν επιπλέον credits. Δείτε την ενότητα Credits για λεπτομέρειες.

Ρύθμιση

Claude Desktop

Προσθέστε τα παρακάτω στο αρχείο ρυθμίσεων του Claude Desktop:

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": "TO_API_KEY_SAS"
      }
    }
  }
}

Claude Code (CLI)

Εκτελέστε αυτή την εντολή στο terminal:

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

Cursor / Άλλοι MCP Clients

Χρησιμοποιήστε τα παρακάτω στοιχεία σύνδεσης:

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

Διαθέσιμα εργαλεία

Ο MCP server παρέχει 12 εργαλεία που μπορεί να χρησιμοποιήσει ο AI assistant σας:

search

Γρήγορη αναζήτηση ελεύθερου κειμένου σε εταιρείες και πρόσωπα. Κατάλληλο για natural-language queries: όνομα εταιρείας, όνομα προσώπου, ΑΦΜ, ΑΡ ΓΕΜΗ ή τμήμα τίτλου. Επιστρέφει μικτά αποτελέσματα (εταιρείες + πρόσωπα) ταξινομημένα κατά συνάφεια.

search_companies

Προηγμένη αναζήτηση με φίλτρα για δραστηριότητες (κωδικοί ΚΑΔ/NACE), τοποθεσία, νομική μορφή, κατάσταση, ακτίνα GPS και πολλά άλλα. Επιστρέφει έως 25 αποτελέσματα (χωρίς όριο για premium).

Βασικές παράμετροι

`query`	Ελεύθερη αναζήτηση κειμένου
`activities`	Κωδικοί δραστηριότητας ΚΑΔ/NACE
`cities`	Φίλτρο πόλης
`has_email`	Μόνο εταιρείες με email
`status`	"active", "inactive" ή "all"
`gps_center_lat/lon/radius_km`	Αναζήτηση με ακτίνα GPS

get_company

Πλήρες προφίλ εταιρείας βάσει αριθμού μητρώου (ΑΡ ΓΕΜΗ). Η προεπιλεγμένη απάντηση περιλαμβάνει επωνυμία, ΑΦΜ, διεύθυνση, νομική μορφή, κύρια δραστηριότητα με benchmark κλάδου, τελευταία οικονομικά στοιχεία, risk flags (αφερεγγυότητα / παραβάσεις ΑΑΔΕ / κυρώσεις / ΠΕΠ / οφειλές δημοσίου) και υποκαταστήματα, δηλαδή άλλες οντότητες με το ίδιο ΑΦΜ, που καλύπτουν τόσο φυσικά υποκαταστήματα όσο και διαδόχους από εταιρικούς μετασχηματισμούς. Με το include_sections παίρνετε βαθύτερα δεδομένα: contact, social, activities, people, financials, documents, related_companies, risk, rankings, stock_listing, subsidies, procurement, objective, titles, public_debtor.

get_company_by_vat

Αναζήτηση εταιρείας με ΑΦΜ. Υποστηρίζει ελληνικό και ευρωπαϊκό format ΑΦΜ.

search_activities

Αναζήτηση κωδικών δραστηριότητας ΚΑΔ/NACE βάσει λέξης-κλειδί. Χρησιμοποιήστε το για να βρείτε τον σωστό κωδικό πριν αναζητήσετε εταιρείες.

get_person

Στοιχεία προσώπου και όλες οι εταιρείες με τις οποίες συνδέεται (μέτοχος, διευθύνων σύμβουλος, μέλος ΔΣ κ.λπ.).

get_credits

Ελέγξτε τα υπόλοιπα credits σας (AI, lead και API credits).

get_company_news

Πρόσφατα άρθρα ειδήσεων που αναφέρουν συγκεκριμένη ελληνική εταιρεία: press coverage, ανακοινώσεις, εξαγορές. Συγκεντρώνονται από ελληνικά μέσα. Δωρεάν.

check_financial_analysis

Ελέγξτε το κόστος σε AI credits πριν εκτελέσετε οικονομική ανάλυση. Καλείται αυτόματα πριν το analyze_financials.

analyze_financials

Ανάλυση δημοσιευμένων ισολογισμών με AI. Εξάγει έσοδα, κέρδη, ενεργητικό, υποχρεώσεις, ίδια κεφάλαια, ταμειακά διαθέσιμα κ.ά. Κόστος 1 AI credit ανά έγγραφο ισολογισμού που αναλύεται. Ένας τυπικός ελληνικός ισολογισμός περιέχει τη χρήση του έτους μαζί με συγκριτικές στήλες της προηγούμενης, οπότε μία κλήση του 1 credit συνήθως επιστρέφει 2 έτη (τα επιπλέον έτη αποθηκεύονται και επιστρέφονται δωρεάν ως bonus_periods). Idempotent: αν το έτος έχει ήδη αναλυθεί, επιστρέφει τα αποθηκευμένα δεδομένα με credits_charged: 0. Με force_reanalyze: true τρέχει ξανά η ανάλυση.

check_export_leads

Ελέγξτε το κόστος σε lead credits πριν την εξαγωγή. Επιστρέφει αριθμό εταιρειών προς εξαγωγή και εκτίμηση κόστους.

export_leads

Εξαγωγή στοιχείων επικοινωνίας εταιρειών (emails, τηλέφωνα). Κόστος 1 lead credit ανά εταιρεία με έγκυρο email.

Credits & τιμολόγηση

Οι κλήσεις MCP εργαλείων χρησιμοποιούν το ίδιο σύστημα credits με το REST API:

Ενέργεια	Κόστος
Οποιαδήποτε κλήση εργαλείου (αναζήτηση, προφίλ εταιρείας κ.λπ.)	1 API credit
AI οικονομική ανάλυση	1 API credit + 1 AI credit ανά έτος
Εξαγωγή leads	1 API credit + 1 lead credit ανά εταιρεία
Έλεγχος credits / Αναζήτηση δραστηριοτήτων	Δωρεάν

Αγοράστε credits στη σελίδα Credits.

Παραδείγματα χρήσης

Μόλις ρυθμίσετε τη σύνδεση, απλά ρωτήστε τον AI assistant σας φυσικά:

Έρευνα αγοράς

"Θέλω να ανοίξω σουβλατζίδικο στην οδό Ερμού στην Αθήνα.
Τι ανταγωνισμό έχω; Πόσα εστιατόρια υπάρχουν
στην περιοχή και ποια είναι τα οικονομικά τους;"

Lead generation

"Βρες όλες τις ενεργές εταιρείες λογισμικού στη Θεσσαλονίκη
που έχουν email. Θέλω τα στοιχεία επικοινωνίας τους."

Έρευνα εταιρείας

"Ψάξε την εταιρεία με ΑΦΜ 123456789.
Ποιοι είναι οι μέτοχοι; Ποια είναι η πορεία των εσόδων;"

Οικονομική ανάλυση

"Ανάλυσε τα οικονομικά έγγραφα της εταιρείας 170000000000
για τα τελευταία 3 χρόνια. Σύγκρινε έσοδα και κερδοφορία."

Χρειάζεστε βοήθεια;

Στείλτε email στο support@bizlist.gr ή χρησιμοποιήστε τη φόρμα επικοινωνίας. Συνήθως απαντάμε εντός 24 ωρών τις εργάσιμες ημέρες.

Για τεκμηρίωση REST API, δείτε τα API Docs. Πολιτική απορρήτου: /docs/el/privacy/ · Όροι χρήσης: /docs/el/terms/.