MCP Tool

Internetmarke: Briefmarken suchen und abrufen SELECT

Gekaufte Internetmarken mit Trackingcode, Bestellnummer, Postprodukt, Betrag (Euro), PPL-Version, Bezug (App und ID, z. B. Lieferung), Kundennummer, ob abgerufen, ob frei (ohne Bezug und nicht abgerufen), Benutzer und Datum; Suche, Filter, Sortierung und Seiten (_meta). Mit ID genau eine Briefmarke mit Angabe, ob die ZIP-Datei vorliegt, und Anzahl der Meldungen des Bezugs. Keine Adressen, keine Download-Links.

Tool-Name

tool

select_internetmarke_briefmarken

Parameter

Parameter	Typ	Pflicht	Beschreibung
`abgerufen`	`string`	Nein	1 = nur abgerufene, 0 = nur nicht abgerufene Briefmarken.
`bezug_ID`	`integer`	Nein	ID des Bezugs in dieser App.
`bezug_modul`	`string`	Nein	App des Bezugs: lieferungen, rechnungen oder anschreiben.
`datum_bis`	`string`	Nein	Datum YYYY-MM-DD, einschliesslich.
`datum_von`	`string`	Nein	Datum YYYY-MM-DD.
`detailgrad`	`string`	Nein	Nur uebersicht.
`erstellt_von`	`string`	Nein	tricoma-Benutzer, der die Briefmarke gekauft hat.
`help`	`integer`	Nein	Filterhilfe.
`ID`	`integer`	Nein	Eine Briefmarke abrufen (interne ID, kein Trackingcode); andere Filter werden dann ignoriert.
`kundennummer`	`integer`	Nein	Nur Briefmarken dieses Kunden.
`lieferung_ID`	`array`	Nein	Nur Briefmarken zu diesen Lieferungen.
`limit`	`integer`	Nein	Eintraege je Seite, 1 bis 200, Standard 50.
`nur_frei`	`string`	Nein	1 = nur freie Briefmarken (ohne Bezug, nicht abgerufen).
`offset`	`integer`	Nein	Startposition ab 0, Standard 0. Naechste Seite: offset + limit, solange _meta.has_more true ist.
`postprodukt`	`integer`	Nein	Produktcode des Postprodukts (siehe select_internetmarke_postprodukte).
`sortierung`	`string`	Nein	Ein Wert, Minus = absteigend. Standard: -datum.
`suche`	`string`	Nein	Suchtext in Trackingcode oder Bestellnummer.
`suchtyp`	`string`	Nein	– Standard: `internetmarke_briefmarken`

Input Schema

json

{
    "type": "object",
    "properties": {
        "ID": {
            "type": "integer",
            "description": "Eine Briefmarke abrufen (interne ID, kein Trackingcode); andere Filter werden dann ignoriert.",
            "minimum": 1
        },
        "suche": {
            "type": "string",
            "description": "Suchtext in Trackingcode oder Bestellnummer.",
            "maxLength": 100
        },
        "bezug_modul": {
            "type": "string",
            "description": "App des Bezugs: lieferungen, rechnungen oder anschreiben.",
            "maxLength": 50
        },
        "bezug_ID": {
            "type": "integer",
            "description": "ID des Bezugs in dieser App.",
            "minimum": 1
        },
        "lieferung_ID": {
            "type": "array",
            "items": {
                "type": "integer"
            },
            "description": "Nur Briefmarken zu diesen Lieferungen.",
            "minItems": 1,
            "maxItems": 500
        },
        "kundennummer": {
            "type": "integer",
            "description": "Nur Briefmarken dieses Kunden.",
            "minimum": 1
        },
        "postprodukt": {
            "type": "integer",
            "description": "Produktcode des Postprodukts (siehe select_internetmarke_postprodukte).",
            "minimum": 1
        },
        "abgerufen": {
            "type": "string",
            "description": "1 = nur abgerufene, 0 = nur nicht abgerufene Briefmarken.",
            "enum": [
                0,
                1
            ],
            "werte": [
                "nein",
                "ja"
            ]
        },
        "nur_frei": {
            "type": "string",
            "description": "1 = nur freie Briefmarken (ohne Bezug, nicht abgerufen).",
            "enum": [
                0,
                1
            ],
            "werte": [
                "nein",
                "ja"
            ]
        },
        "erstellt_von": {
            "type": "string",
            "description": "tricoma-Benutzer, der die Briefmarke gekauft hat.",
            "maxLength": 100
        },
        "datum_von": {
            "type": "string",
            "format": "date",
            "description": "Datum YYYY-MM-DD."
        },
        "datum_bis": {
            "type": "string",
            "format": "date",
            "description": "Datum YYYY-MM-DD, einschliesslich."
        },
        "sortierung": {
            "type": "string",
            "description": "Ein Wert, Minus = absteigend. Standard: -datum.",
            "enum": [
                "id",
                "-id",
                "datum",
                "-datum",
                "betrag",
                "-betrag"
            ],
            "werte": {
                "id": "id aufsteigend",
                "-id": "id absteigend",
                "datum": "datum aufsteigend",
                "-datum": "datum absteigend",
                "betrag": "betrag aufsteigend",
                "-betrag": "betrag absteigend"
            }
        },
        "limit": {
            "type": "integer",
            "description": "Eintraege je Seite, 1 bis 200, Standard 50.",
            "minimum": 1,
            "maximum": 200
        },
        "offset": {
            "type": "integer",
            "description": "Startposition ab 0, Standard 0. Naechste Seite: offset + limit, solange _meta.has_more true ist.",
            "minimum": 0
        },
        "detailgrad": {
            "type": "string",
            "description": "Nur uebersicht.",
            "enum": [
                "uebersicht"
            ]
        },
        "help": {
            "type": "integer",
            "enum": [
                1
            ],
            "description": "Filterhilfe."
        },
        "suchtyp": {
            "type": "string",
            "enum": [
                "internetmarke_briefmarken"
            ],
            "default": "internetmarke_briefmarken"
        }
    },
    "additionalProperties": false
}

Beispiel-Aufruf

json

{
    "tool": "select_internetmarke_briefmarken",
    "arguments": {
        "abgerufen": "...",
        "bezug_ID": 1,
        "bezug_modul": "...",
        "datum_bis": "...",
        "datum_von": "...",
        "detailgrad": "...",
        "erstellt_von": "...",
        "help": 1,
        "ID": 1,
        "kundennummer": 1,
        "lieferung_ID": [],
        "limit": 1,
        "nur_frei": "...",
        "offset": 1,
        "postprodukt": 1,
        "sortierung": "...",
        "suche": "...",
        "suchtyp": "internetmarke_briefmarken"
    }
}