mitroo API
Model Context Protocol (MCP) · 32 εργαλεία
Το mitroo δεν έχει μόνο web εφαρμογή — είναι και MCP server. Σύνδεσε τον δικό σου Claude, το ChatGPT ή το Claude Code στο terminal, και το AI σου αποκτά απευθείας πρόσβαση στα δεδομένα ΓΕΜΗ, τις λίστες στόχευσης και τις καμπάνιες cold email σου — με τα δικαιώματα του δικού σου λογαριασμού. Από την πρώτη στιγμή ξέρει και τον λογαριασμό σου: το tool get_started καλείται αυτόματα στην αρχή κάθε συνομιλίας και του δίνει το πλάνο, τα όρια και τις πρώτες προτάσεις.
https://mitroo.ai/api/mcpAuthorization: Bearer mk_live_…https://mitroo.ai/api/mcp/<κλειδί>Ξεκίνημα σε 3 βήματα
claude mcp add με Bearer header.get_started: μαθαίνει την πλατφόρμα, το πλάνο και τα όριά σου, και σου προτείνει από μόνο του τι άνοιξε στον κλάδο σου. Δες και τις Οδηγίες.Τα εργαλεία
Κάθε εργαλείο είναι διαθέσιμο στο AI σου ανάλογα με τα δικαιώματα του λογαριασμού σου (RBAC). Τα στοιχεία επικοινωνίας επιστρέφονται πάντα μασκαρισμένα κατά το πλάνο σου.
Δεδομένα & αναζήτηση
get_startedΚάλεσέ το ΠΡΩΤΟ, ΜΙΑ φορά στην αρχή κάθε συνομιλίας.search_companiesΑναζήτηση στο δημόσιο μητρώο επιχειρήσεων (εταιρικές & ατομικές) με όνομα, ΑΦΜ ή αριθμό ΓΕΜΗ.get_companyΠλήρες προφίλ μιας εταιρείας από τον αριθμό ΓΕΜΗ.check_contactedΕλέγχει ποιους από μια λίστα emails έχεις ΗΔΗ προσεγγίσει (duplicate-send guard).dataset_statsΤι περιέχει το mitroo: σύνολο ελληνικών επιχειρήσεων (ΓΕΜΗ), πόσες με επαφή ιδιοκτήτη, πόσες με επαγγελματικό email, πιο πρόσφατη διαθέσιμη ημέρα σύστασης, τελευταίο refresh δεδομένων, top νομοί.browse_companiesΣτοχευμένη περιήγηση στον κατάλογο επιχειρήσεων με συνδυαστικά φίλτρα: κλάδος (4ψήφιο πρόθεμα ΚΑΔ π.χ.contact_historyΤο ιστορικό επικοινωνίας με μια επαφή: τι email της έχεις στείλει και τι απάντησε (θέματα + αποσπάσματα).targeting_optionsΔεδομένα αναφοράς για στόχευση — ΚΑΛΕΣΕ ΤΟ ΠΡΙΝ από browse_companies/find_new_companies όταν χρειάζεσαι IDs: νομοί με τα prefectureIds τους, δήμοι (municipalityIds) ομαδοποιημένοι ανά νομό, ενότητες ΚΑΔ (sections) με τους 2ψήφιους κλάδους τους, νομικές μορφές.market_trendsΤάσεις της ελληνικής αγοράς από το ΓΕΜΗ (η «Αγορά» του mitroo): τι ανοίγει/κλείνει ανά κλάδο/είδος/νομό, επιβίωση νέων επιχειρήσεων, κεφάλαια, νομικές μορφές.list_areasΚατάλογος γεωγραφικών περιοχών με τα gid τους (GADM): περιφέρειες (pref, π.χ.area_profileΠροφίλ μιας γεωγραφικής περιοχής (περιφέρεια ή δήμος) από τα geo marts του mitroo: ενεργές επιχειρήσεις, νέες τελευταίου 30ημέρου vs προηγούμενου, νέες από αρχή έτους, μέση ηλικία, top είδη, τι ανεβαίνει (trending), σύνοψη κεφαλαίων.Νεοσύστατες επιχειρήσεις
find_new_companiesΒρίσκει νεοσύστατες εταιρείες (feed «Νεοσύστατες» του ΓΕΜΗ).Λίστες στόχευσης
list_saved_listsΟι αποθηκευμένες λίστες στόχευσής σου (όνομα, πλήθος αποτελεσμάτων, ημερομηνία).get_saved_listΤο περιεχόμενο μιας αποθηκευμένης λίστας στόχευσης: οι επιχειρήσεις με mailable email (όνομα, ΓΕΜΗ, email μασκαρισμένο κατά τα δικαιώματά σου).create_listΔημιουργεί αποθηκευμένη λίστα στόχευσης από φίλτρα καταλόγου (ίδια με browse_companies).update_listΕπεξεργάζεται αποθηκευμένη λίστα: νέο όνομα ή/και νέα φίλτρα (τα φίλτρα ΑΝΤΙΚΑΘΙΣΤΟΥΝ πλήρως τα παλιά και το πλήθος επανυπολογίζεται).Καμπάνιες cold email
list_campaignsΟι καμπάνιες email σου (id, όνομα, κατάσταση, ημερήσιο όριο).get_campaignΛεπτομέρειες μιας καμπάνιας: πρόγραμμα, παραλήπτες και προσωποποιημένα drafts.create_campaignΦτιάχνει καμπάνια ως ΠΡΟΧΕΙΡΟ (draft) — ΔΕΝ στέλνει email.update_draftΕπεξεργάζεται το προσωποποιημένο email (θέμα/σώμα) ενός παραλήπτη μιας καμπάνιας.update_scheduleΟρίζει το πρόγραμμα αποστολής μιας καμπάνιας (ημέρες 1=Δευ…7=Κυρ, ώρα από/έως).pause_campaignΠαύει μια ενεργή καμπάνια — σταματά προσωρινά την αποστολή.contact_slotsΠόσες αποθηκευμένες επαφές δικαιούσαι, πόσες χρησιμοποιείς και πόσες σου μένουν.free_contact_slotsΕλευθερώνει θέσεις επαφών διαγράφοντας τους παραλήπτες μιας ΟΛΟΚΛΗΡΩΜΕΝΗΣ καμπάνιας.mailbox_statusΚατάσταση των θυρίδων αποστολής σου: warmup score, ενεργοποίηση warmup, ετοιμότητα για αποστολή.remove_recipientΑφαιρεί έναν παραλήπτη από καμπάνια (πριν του σταλεί οτιδήποτε).delete_campaignΔΙΑΓΡΑΦΕΙ ολόκληρη καμπάνια (μη αναστρέψιμο).archive_campaignΑρχειοθετεί μια καμπάνια ώστε να μην μετράει στα στατιστικά (ή την επαναφέρει με archived=false).add_recipientsΠροσθέτει παραλήπτες σε ΥΠΑΡΧΟΥΣΑ καμπάνια (max 100, με προαιρετικό προσωποποιημένο subject/body ανά παραλήπτη).Αποστολή — με ρητή επιβεβαίωση
activate_campaignΕΚΚΙΝΕΙ μια καμπάνια — στέλνει ΠΡΑΓΜΑΤΙΚΑ email.reply_to_contactΣτέλνει ΠΡΑΓΜΑΤΙΚΟ email σε υπάρχον thread επαφής: αν σου έχει απαντήσει → reply στο πιο πρόσφατο εισερχόμενό της· αν ΔΕΝ έχει απαντήσει → follow-up (δεύτερη προσέγγιση) πάνω στο δικό σου προηγούμενο email, στο ίδιο thread.Στατιστικά
campaign_statsΣτατιστικά καμπανιών: απεσταλμένα, απαντήσεις, αναπηδήσεις (bounces).Ασφάλεια
Τα κλειδιά (mk_live_…) αποθηκεύονται hashed — κανείς δεν μπορεί να τα ξαναδεί, ούτε εμείς — και ανακαλούνται με ένα κλικ. Κάθε κλήση περνά από το ίδιο RBAC με το web app: ό,τι δεν βλέπεις στην εφαρμογή, δεν το βλέπει ούτε το AI σου. Οι ενέργειες που στέλνουν πραγματικά email απαιτούν ρητή επιβεβαίωση, με αυτόματο έλεγχο για επαφές που έχεις ήδη προσεγγίσει. Όλες οι κλήσεις καταγράφονται σε audit log.
Κόστος
Το API περιλαμβάνεται στο πλάνο σου — χωρίς επιπλέον χρέωση, χωρίς credits ανά κλήση. Ισχύουν τα όρια του πλάνου (π.χ. όγκος αποστολής email).