MCP Server για AI Assistants

Συνδεστε τον AI assistant σας απευθειας στη βαση δεδομενων του BizList.gr. Αναζητηστε 2.5M+ ελληνικες εταιρειες, αναλυστε οικονομικα στοιχεια, εξαγετε leads - ολα μεσω φυσικης γλωσσας.

Τι ειναι το MCP;

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

Το MCP υποστηριζεται απο:

Claude Desktop (Anthropic)
Claude Code (CLI)
Cursor, Windsurf και αλλους AI-enabled editors
Οποιονδηποτε MCP-compatible client

Ξεκινωντας

Χρειαζεστε εναν λογαριασμο BizList.gr με 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 παρεχει 10 εργαλεια που μπορει να χρησιμοποιησει ο AI assistant σας:

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

Πληρες προφιλ εταιρειας βασει αριθμου μητρωου (ΑΡ ΓΕΜΗ). Επιστρεφει δραστηριοτητες, προσωπα, εγγραφα, οικονομικα, στοιχεια επικοινωνιας και συνδεδεμενες εταιρειες.

get_company_by_vat

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

search_activities

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

get_person

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

get_credits

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

check_financial_analysis

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

analyze_financials

Αναλυση δημοσιευμενων ισολογισμων με AI. Εξαγει εσοδα, κερδη, ενεργητικο, υποχρεωσεις. Κοστος 1 AI credit ανα ετος αναλυσης.

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 χρονια. Συγκρινε εσοδα και κερδοφορια."

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

Αν εχετε ερωτησεις για τον MCP server, επικοινωνηστε μαζι μας.

Για τεκμηριωση REST API, δειτε τα API Docs.