Ihre Flottendaten in der KI-Anwendung

Der ARTECO MCP öffnet Ihrer KI-Anwendung den Zugang zu den Daten Ihrer ARTECO-Flotte: Fahrzeuge, Positionen, Fahrten, Tankungen, Standorte, Mitarbeiter und Zeiterfassung. Der Dienst liest nur, er legt nichts an und ändert nichts. Jede Anfrage braucht Ihre eigene Anmeldung an der ARTECO API, Sie sehen damit genau die Daten, die Ihnen auch im Portal gehören. Bereit stehen 18 Werkzeuge; dazu beschreibt der Katalog 92 lesende Routen aus 38 Ressourcen.

Diese Adresse trägt Ihre KI-Anwendung ein:

https://mcp.arteco.ai/mcp/

Welche Zeilen dafür wohin gehören, zeigt die Anleitung je Client.

Kern

Die häufigen Fragen an die Flotte, fertig zugeschnitten.

whoami

Meldet, als wer diese Anfrage bei der ARTECO API angemeldet ist.

Ohne Parameter.

whoami()

list_vehicles

Listet die Fahrzeuge des angemeldeten Kunden.

updated_since grenzt auf Fahrzeuge ein, die seit diesem Datum geändert wurden.

Parameter	Typ	Angabe
updated_since	string	optional

list_vehicles()

get_vehicle

Liefert den vollen Datensatz eines Fahrzeugs, ohne Gerätepasswort und PIN.

Parameter	Typ	Angabe
vehicle_uuid	string	Pflicht

get_vehicle(vehicle_uuid="3fa85f64-5717-4562-b3fc-2c963f66afa6")

get_vehicle_position

Liefert die zuletzt gemeldete Position eines Fahrzeugs.

Die Werte stammen aus dem Fahrzeugsatz, nicht aus der Positionsliste. world_x und world_y sind Längen- und Breitengrad, last_map_text die Adresse dazu.

Parameter	Typ	Angabe
vehicle_uuid	string	Pflicht

get_vehicle_position(vehicle_uuid="3fa85f64-5717-4562-b3fc-2c963f66afa6")

list_positions

Listet die Einzelpositionen eines Fahrzeugs in einem Zeitraum.

from_day und to_day sind Pflicht und dürfen höchstens sieben Tage auseinander liegen. Ohne diese Grenze belastet die Abfrage die API zu stark.

Parameter	Typ	Angabe
vehicle_uuid	string	Pflicht
from_day	string	Pflicht
to_day	string	Pflicht
limit	integer	optional
page	integer	optional

list_positions(vehicle_uuid="3fa85f64-5717-4562-b3fc-2c963f66afa6", from_day="2026-09-01", to_day="2026-09-07")

list_travels

Listet die Fahrten eines Fahrzeugs, mit Start, Ziel, Strecke und Fahrer.

Ohne limit liefert die API nur einen einzigen Eintrag.

Parameter	Typ	Angabe
vehicle_uuid	string	Pflicht
from_day	string	optional
to_day	string	optional
limit	integer	optional
page	integer	optional

list_travels(vehicle_uuid="3fa85f64-5717-4562-b3fc-2c963f66afa6")

count_travels_by_day

Zählt die Fahrten eines Fahrzeugs je Tag im angegebenen Zeitraum.

Parameter	Typ	Angabe
vehicle_uuid	string	Pflicht
from_day	string	Pflicht
to_day	string	Pflicht

count_travels_by_day(vehicle_uuid="3fa85f64-5717-4562-b3fc-2c963f66afa6", from_day="2026-09-01", to_day="2026-09-07")

list_refuelings

Listet die Tankungen eines Fahrzeugs.

Parameter	Typ	Angabe
vehicle_uuid	string	Pflicht
from_day	string	optional
to_day	string	optional
limit	integer	optional
page	integer	optional

list_refuelings(vehicle_uuid="3fa85f64-5717-4562-b3fc-2c963f66afa6")

list_coworkers

Listet die Mitarbeiter, ohne Ausweisnummern sowie Steuernummer.

Parameter	Typ	Angabe
updated_since	string	optional

list_coworkers()

list_timekeepings

Listet die Zeiterfassungen eines Mitarbeiters.

Parameter	Typ	Angabe
coworker_uuid	string	Pflicht
from_day	string	optional
to_day	string	optional
limit	integer	optional
page	integer	optional

list_timekeepings(coworker_uuid="3fa85f64-5717-4562-b3fc-2c963f66afa6")

count_timekeepings_by_day

Zählt die Zeiterfassungen eines Mitarbeiters je Tag.

Dies ist ein anderer Endpunkt als count_travels_by_day, trotz des gleichen Namens in der API.

Parameter	Typ	Angabe
coworker_uuid	string	Pflicht
from_day	string	Pflicht
to_day	string	Pflicht

count_timekeepings_by_day(coworker_uuid="3fa85f64-5717-4562-b3fc-2c963f66afa6", from_day="2026-09-01", to_day="2026-09-07")

get_coworker_overview

Liefert die Übersicht eines Mitarbeiters mit Arbeitszeit, Urlaub und Konto.

Parameter	Typ	Angabe
coworker_uuid	string	Pflicht

get_coworker_overview(coworker_uuid="3fa85f64-5717-4562-b3fc-2c963f66afa6")

list_locations

Listet die hinterlegten Standorte, also Kunden, Baustellen und Lager.

Parameter	Typ	Angabe
updated_since	string	optional

list_locations()

list_reservations

Listet Reservierungen, ohne vehicle_uuid über alle Fahrzeuge.

Parameter	Typ	Angabe
vehicle_uuid	string	optional
from_day	string	optional
to_day	string	optional
limit	integer	optional
page	integer	optional

list_reservations()

geocode

Sucht Koordinaten zu einer Adresse oder einem Ort.

Parameter	Typ	Angabe
query	string	Pflicht

geocode(query="Hauptstraße 1, Potsdam")

Katalog

Für alles darüber hinaus: der erzeugte Katalog über die lesbaren Ressourcen der ARTECO API.

describe_resource

Nennt die lesbaren Ressourcen der ARTECO API.

Ohne resource kommt die Liste aller Ressourcen. Mit resource kommen deren Routen samt Pfadangaben und Filtern. Dieses Werkzeug ruft die API nicht.

Parameter	Typ	Angabe
resource	string	optional

describe_resource()

list_resource

Listet eine beliebige Ressource der ARTECO API.

Welche Namen es gibt, sagt describe_resource. Verschachtelte Listen wie die Positionen eines Fahrzeugs haben eigene Kernwerkzeuge.

Parameter	Typ	Angabe
resource	string	Pflicht
from_day	string	optional
to_day	string	optional
limit	integer	optional
page	integer	optional
items	integer	optional

list_resource(resource="locations")

get_resource

Liefert einen einzelnen Datensatz einer Ressource über seine uuid.

Parameter	Typ	Angabe
resource	string	Pflicht
uuid	string	Pflicht

get_resource(resource="locations", uuid="3fa85f64-5717-4562-b3fc-2c963f66afa6")