amego MCP by usefulapi
Look up invoices, allowances and number ranges, and check government upload status in amego.
사용해야 할까요
품질 및 안전성
발견 사항 (2)
- LOWamego_get_invoice_upload_status에서
- LOWamego_get_allowance_upload_status에서
도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.
컨텍스트 비용
이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.
설치
원클릭 설치
`claude_desktop_config.json` 파일에 다음을 추가하세요:
{
"mcpServers": {
"amego": {
"url": "https://amego.usefulapi.io/mcp"
}
}
}원격 엔드포인트
https://amego.usefulapi.io/mcpstreamable-http할 수 있는 일
도구 목록
도구 (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.
입력 스키마
{
"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.
입력 스키마
{
"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.
입력 스키마
{
"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.
입력 스키마
{
"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.
입력 스키마
{
"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.
입력 스키마
{
"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.
입력 스키마
{
"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.
입력 스키마
{
"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.
입력 스키마
{
"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.
입력 스키마
{
"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.
입력 스키마
{
"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.
입력 스키마
{
"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.
입력 스키마
{
"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"
}커뮤니티
증거