amego MCP by usefulapi
Look up invoices, allowances and number ranges, and check government upload status in amego.
Sollte ich dies verwenden
Qualität und Sicherheit
Befunde (2)
- LOWin amego_get_invoice_upload_status
- LOWin amego_get_allowance_upload_status
Basierend auf einer automatisierten Analyse der Tool-Definitionen und der Einhaltung des Protokolls.
Kontextkosten
Dies ist die ungefähre Anzahl der Tokens, die jedes Mal verbraucht werden, wenn die Tools des Servers in den Kontext eines Modells geladen werden. Höhere Werte verringern die Aufmerksamkeit, die für andere Aufgaben verfügbar ist.
Installieren
Installation mit einem Klick
Fügen Sie dies Ihrer Datei `claude_desktop_config.json` hinzu:
{
"mcpServers": {
"amego": {
"url": "https://amego.usefulapi.io/mcp"
}
}
}Remote-Endpunkte
https://amego.usefulapi.io/mcpstreamable-httpWas es kann
Tool-Inventar
Tools (13)
🟢amego_query_invoice(by, value)
Look up one invoice by its invoice number, or by the order number it was issued for. Finds invoices dated within the last 180 days. amego: POST /json/invoice_query.
Eingabe-Schema
{
"type": "object",
"properties": {
"by": {
"type": "string",
"enum": [
"invoice",
"order"
],
"description": "invoice = look up by invoice number; order = look up by order number."
},
"value": {
"type": "string",
"minLength": 1,
"maxLength": 40,
"description": "The invoice number (at most 10 characters) or the order number (at most 40 characters)."
}
},
"required": [
"by",
"value"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢amego_list_invoices(date_select, date_start, date_end, limit, page)
List the invoices of the company in a date range, one page at a time (headers only: number, dates, buyer, amounts, status). amego: POST /json/invoice_list.
Eingabe-Schema
{
"type": "object",
"properties": {
"date_select": {
"anyOf": [
{
"type": "number",
"const": 1
},
{
"type": "number",
"const": 2
}
],
"description": "Which date to filter on: 1 = invoice date, 2 = creation date."
},
"date_start": {
"type": "string",
"pattern": "^\\d{8}$",
"description": "Date as YYYYMMDD, for example 20241031."
},
"date_end": {
"type": "string",
"pattern": "^\\d{8}$",
"description": "Date as YYYYMMDD, for example 20241031."
},
"limit": {
"description": "Rows per page, 20 to 500 (default 20).",
"type": "integer",
"minimum": 20,
"maximum": 500
},
"page": {
"description": "Page number (default 1).",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
}
},
"required": [
"date_select",
"date_start",
"date_end"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢amego_get_invoice_upload_status(invoice_numbers)
Check whether the government has accepted each invoice number: the upload status, invoice type, status and total amount. Up to 50 numbers per call. amego: POST /json/invoice_status.
Eingabe-Schema
{
"type": "object",
"properties": {
"invoice_numbers": {
"minItems": 1,
"maxItems": 50,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 10,
"description": "Invoice number, at most 10 characters, for example AA12301393."
},
"description": "Invoice numbers to check, up to 50."
}
},
"required": [
"invoice_numbers"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢amego_get_invoice_file(by, value, download_style)
Get a link to the PDF of one invoice (valid for 10 minutes). A carrier invoice can be downloaded only after it wins a prize. amego: POST /json/invoice_file.
Eingabe-Schema
{
"type": "object",
"properties": {
"by": {
"type": "string",
"enum": [
"invoice",
"order"
],
"description": "invoice = look up by invoice number; order = look up by order number."
},
"value": {
"type": "string",
"minLength": 1,
"maxLength": 40,
"description": "The invoice number (at most 10 characters) or the order number (at most 40 characters)."
},
"download_style": {
"description": "PDF layout. 0 = A4 full page (default for invoices with a buyer tax ID), 1 = A4 with address and A5, 2 = A4 with two A5, 3 = A5, 5 = QR code A4.",
"anyOf": [
{
"type": "number",
"const": 0
},
{
"type": "number",
"const": 1
},
{
"type": "number",
"const": 2
},
{
"type": "number",
"const": 3
},
{
"type": "number",
"const": 5
}
]
}
},
"required": [
"by",
"value"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢amego_check_lottery_invoices(year, period)
List the company's invoices that won a prize in one two-month period. amego advises asking on the 1st day of an even month, after the draw. amego: POST /json/lottery_status.
Eingabe-Schema
{
"type": "object",
"properties": {
"year": {
"type": "integer",
"minimum": 2000,
"maximum": 2100,
"description": "Western calendar year, for example 2026."
},
"period": {
"type": "integer",
"minimum": 0,
"maximum": 5,
"description": "Two-month period: 0 = Jan-Feb, 1 = Mar-Apr, 2 = May-Jun, 3 = Jul-Aug, 4 = Sep-Oct, 5 = Nov-Dec."
}
},
"required": [
"year",
"period"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢amego_get_track_status(year, period, track_api_code)
Show the status of the invoice number ranges (字軌) that use API number assignment, for one period. Optionally one range by its API code. amego: POST /json/track_status.
Eingabe-Schema
{
"type": "object",
"properties": {
"year": {
"type": "integer",
"minimum": 2000,
"maximum": 2100,
"description": "Western calendar year, for example 2026."
},
"period": {
"type": "integer",
"minimum": 0,
"maximum": 5,
"description": "Two-month period: 0 = Jan-Feb, 1 = Mar-Apr, 2 = May-Jun, 3 = Jul-Aug, 4 = Sep-Oct, 5 = Nov-Dec."
},
"track_api_code": {
"description": "API code of one number range, set in the amego back office. Omit for all ranges.",
"type": "string",
"minLength": 1,
"maxLength": 20
}
},
"required": [
"year",
"period"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢amego_list_track_ranges(year, period)
List every invoice number range (字軌) the company holds at amego for one period: the layer, the category, the start and end numbers, and how many remain. amego: POST /json/track_all.
Eingabe-Schema
{
"type": "object",
"properties": {
"year": {
"type": "integer",
"minimum": 2000,
"maximum": 2100,
"description": "Western calendar year, for example 2026."
},
"period": {
"type": "integer",
"minimum": 0,
"maximum": 5,
"description": "Two-month period: 0 = Jan-Feb, 1 = Mar-Apr, 2 = May-Jun, 3 = Jul-Aug, 4 = Sep-Oct, 5 = Nov-Dec."
}
},
"required": [
"year",
"period"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢amego_query_allowance(allowance_number)
Look up one allowance (折讓單) by its allowance number. amego: POST /json/allowance_query.
Eingabe-Schema
{
"type": "object",
"properties": {
"allowance_number": {
"type": "string",
"minLength": 1,
"maxLength": 16,
"description": "Allowance number (折讓單編號), at most 16 characters."
}
},
"required": [
"allowance_number"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢amego_list_allowances(date_select, date_start, date_end, limit, page)
List the allowances (折讓單) of the company in a date range, one page at a time. amego: POST /json/allowance_list.
Eingabe-Schema
{
"type": "object",
"properties": {
"date_select": {
"anyOf": [
{
"type": "number",
"const": 1
},
{
"type": "number",
"const": 2
}
],
"description": "Which date to filter on: 1 = allowance date, 2 = creation date."
},
"date_start": {
"type": "string",
"pattern": "^\\d{8}$",
"description": "Date as YYYYMMDD, for example 20241031."
},
"date_end": {
"type": "string",
"pattern": "^\\d{8}$",
"description": "Date as YYYYMMDD, for example 20241031."
},
"limit": {
"description": "Rows per page, 20 to 500 (default 20).",
"type": "integer",
"minimum": 20,
"maximum": 500
},
"page": {
"description": "Page number (default 1).",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
}
},
"required": [
"date_select",
"date_start",
"date_end"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢amego_get_allowance_upload_status(allowance_numbers)
Check whether the government has accepted each allowance number: the upload status and the total amount. Up to 50 numbers per call. amego: POST /json/allowance_status.
Eingabe-Schema
{
"type": "object",
"properties": {
"allowance_numbers": {
"minItems": 1,
"maxItems": 50,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 16,
"description": "Allowance number (折讓單編號), at most 16 characters."
},
"description": "Allowance numbers to check, up to 50."
}
},
"required": [
"allowance_numbers"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢amego_get_allowance_file(allowance_number)
Get a link to the PDF of one allowance (折讓單). amego: POST /json/allowance_file.
Eingabe-Schema
{
"type": "object",
"properties": {
"allowance_number": {
"type": "string",
"minLength": 1,
"maxLength": 16,
"description": "Allowance number (折讓單編號), at most 16 characters."
}
},
"required": [
"allowance_number"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢amego_lookup_company_name(tax_ids)
Look up the registered company name for up to 20 tax IDs (統一編號), from the Ministry of Finance data. amego: POST /json/ban_query.
Eingabe-Schema
{
"type": "object",
"properties": {
"tax_ids": {
"minItems": 1,
"maxItems": 20,
"type": "array",
"items": {
"type": "string",
"pattern": "^\\d{8}$",
"description": "8-digit company tax ID (統一編號)."
},
"description": "8-digit tax IDs to look up, up to 20."
}
},
"required": [
"tax_ids"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢amego_check_mobile_barcode(barcode)
Check whether a mobile carrier barcode (手機條碼) is valid. amego: POST /json/barcode.
Eingabe-Schema
{
"type": "object",
"properties": {
"barcode": {
"type": "string",
"minLength": 1,
"maxLength": 8,
"description": "The mobile barcode, 8 characters starting with /, for example /ABC+1+2."
}
},
"required": [
"barcode"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Community
Nachweis