_ registry / mcp streamable-http · checked 12h ago

superfaktura-mcp

https://superfaktura.usefulapi.io

Registry code: 0a807113c3ddde05

api record

Tools for SuperFaktura, hosted by usefulapi.io. Read-only tools never change data; ask the user before a tool that creates, changes or deletes SuperFaktura data. Free plan: 100 tool calls per month. Run superfaktura_usage_status to see the calls used this month. If the user asks for something none of these tools can do, tell the user and, with their OK, run superfaktura_request_feature to record the request. Pro (unlimited calls, $9/month or $90/year): when the user wants more calls or reaches the limit, run superfaktura_upgrade; it returns a Stripe Checkout link for the user to open.…

endpoint
https://superfaktura.usefulapi.io/mcp
protocol
streamable-http ·2025-06-18
authentication
none observed
public key
none — nobody has proven they own this listing · is it yours? claim it
karma
0 · newcomer
_ is it live, free and safe measured by this hub
Is superfaktura-mcp live?
Yes — it answered the hub's last check (checked 12h ago). It answered 100% of checks over the last 30 days.
Is superfaktura-mcp free to use?
No — it asks for a key or a login before it will serve.
What tools does superfaktura-mcp have?
25 tools: superfaktura_list_contact_persons, superfaktura_list_bank_accounts, superfaktura_get_cash_register, superfaktura_get_stock_item, superfaktura_list_countries, superfaktura_get_client, superfaktura_list_tags, superfaktura_get_company, ….
Is superfaktura-mcp safe to connect?
The hub found no text in its card or tool descriptions aimed at the agent reading them. It measures what the server answers, not its code — grant it only the access its tools need.
reachable
live
uptime, 30 days
100%

90 days 100%· all time 100%

latency
167ms

last good check

priced tools
0

of 25 tools

_ answered our checks, 90 days 1 checks · signed record
  • unknown → live
_ usage and payments 30 days

Calls placed through this hub's router, from its own receipts. Every caller and every payer counts the same; the chain total is counted from three payers.

accounts
0

through this hub

calls served
0

successful

paid through this hub
0 USDC

what callers paid

_ what it can do 25 tools
25 auth-required 25 of 25 classified

Price is per tool, not per server. An agent whose handshake is open can hold tools that demand a key or a payment, and one figure for the whole agent sends callers into a wall.

  • superfaktura_list_contact_persons auth-required never probed

    The contact persons (name, e-mail, phone) stored for one client. GET /contact_people/getContactPeople/{client_id}.

    mcp-tool

    {
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "client_id"
  ],
  "properties": {
    "client_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "Client id.",
      "exclusiveMinimum": 0
    }
  }
}
    arguments 15 lines
  • superfaktura_list_bank_accounts auth-required 12h ago

    The company's bank accounts as stored in SuperFaktura (bank name, IBAN, SWIFT, default flag). GET /bank_accounts/index.

    mcp-tool

    {
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {}
}
    arguments 5 lines
  • superfaktura_get_cash_register auth-required never probed

    One cash register with currency, number of entries and current balance (read only). GET /cash_registers/view/{id}.

    mcp-tool

    {
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "cash_register_id"
  ],
  "properties": {
    "cash_register_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "Cash register id (from superfaktura_list_cash_registers).",
      "exclusiveMinimum": 0
    }
  }
}
    arguments 15 lines
  • superfaktura_get_stock_item auth-required never probed

    One warehouse item with SKU, price, VAT, purchase price and quantity in stock. GET /stock_items/view/{id}.

    mcp-tool

    {
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "stock_item_id"
  ],
  "properties": {
    "stock_item_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "Stock item id (from superfaktura_list_stock_items).",
      "exclusiveMinimum": 0
    }
  }
}
    arguments 15 lines
  • superfaktura_list_countries auth-required never probed

    SuperFaktura's country ids with ISO code and EU flag, for the country_id of clients. GET /countries/index/view_full:1.

    mcp-tool

    {
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {}
}
    arguments 5 lines
  • superfaktura_get_client auth-required never probed

    One client with address, tax ids, bank data, default currency/due days/discount and statistics. GET /clients/view/{id}.

    mcp-tool

    {
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "client_id"
  ],
  "properties": {
    "client_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "Client id (from superfaktura_list_clients).",
      "exclusiveMinimum": 0
    }
  }
}
    arguments 15 lines
  • superfaktura_list_tags auth-required never probed

    The tags (id and name) usable on invoices, expenses and clients. GET /tags/index.json.

    mcp-tool

    {
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {}
}
    arguments 5 lines
  • superfaktura_get_company auth-required 12h ago

    The company the API key is working in (name, IČO, DIČ, IČ DPH, address, VAT-payer flag, bank accounts) and the remaining API quota (SuperFaktura's fair-use policy is 1000 requests per day and 31000 per month; every tool call here uses one request). Good first call. With all_companies=true also the other companies the user can access (their ids are the company_id of the login). GET /users/getUserCompaniesData.

    mcp-tool

    {
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "all_companies": {
      "type": "boolean",
      "description": "true = every company the user has access to, not only the current one."
    }
  }
}
    arguments 10 lines
  • superfaktura_list_clients auth-required 12h ago

    List the address book (clients and suppliers) with contact data and totals. search matches name, IČO, DIČ, IČ DPH, bank account, e-mail, address, city, phone, note and tags. Paged: pass next_page as page. GET /clients/index.json.

    mcp-tool

    {
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 100000,
      "minimum": 1,
      "description": "Page number, 1-based (default 1). Use next_page from the previous reply."
    },
    "search": {
      "type": "string",
      "maxLength": 120,
      "minLength": 1,
      "description": "Text to search for (matched by SuperFaktura in names, numbers, e-mails ... of the records)."
    },
    "per_page": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "Results per page, 1-100 (the account's profile default when omitted)."
    },
    "direction": {
      "enum": [
        "ASC",
        "DESC"
      ],
      "type": "string",
      "description": "Sort direction (default DESC)."
    },
    "created_period": {
      "enum": [
        "all",
        "today",
        "yesterday",
        "this_week",
        "this_month",
        "last_month",
        "this_quarter",
        "last_quarter",
        "this_year",
        "last_year"
      ],
      "type": "string",
      "description": "Created in this period."
    },
    "modified_period": {
      "enum": [
        "all",
        "today",
        "yesterday",
        "this_week",
        "this_month",
        "last_month",
        "this_quarter",
        "last_quarter",
        "this_year",
        "last_year"
      ],
      "type": "string",
      "description": "Changed in this period."
    }
  }
}
    arguments 64 lines
  • superfaktura_list_invoices auth-required never probed

    List issued documents with client, items, totals and payment status. type selects the document kind (default regular = ordinary invoices; also proforma, estimate = quote, order, cancel = credit note, delivery, draft, reverse_order; several allowed). Without a date filter SuperFaktura returns only the CURRENT YEAR; use created_period='all' or a date range for older ones. status: issued, partially_paid, paid, overdue. search matches client name, number, VS ... Paged: pass next_page as page. GET /invoices/index.json.

    mcp-tool

    {
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 100000,
      "minimum": 1,
      "description": "Page number, 1-based (default 1). Use next_page from the previous reply."
    },
    "type": {
      "type": "array",
      "items": {
        "enum": [
          "regular",
          "proforma",
          "estimate",
          "order",
          "cancel",
          "delivery",
          "draft",
          "reverse_order"
        ],
        "type": "string"
      },
      "maxItems": 8,
      "minItems": 1,
      "description": "Document types (default: regular)."
    },
    "search": {
      "type": "string",
      "maxLength": 120,
      "minLength": 1,
      "description": "Text to search for (matched by SuperFaktura in names, numbers, e-mails ... of the records)."
    },
    "status": {
      "enum": [
        "issued",
        "partially_paid",
        "paid",
        "overdue"
      ],
      "type": "string",
      "description": "Payment status."
    },
    "order_no": {
      "type": "string",
      "maxLength": 40,
      "minLength": 1,
      "description": "Order number the document was created from."
    },
    "per_page": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "Results per page, 1-100 (the account's profile default when omitted)."
    },
    "variable": {
      "type": "string",
      "maxLength": 40,
      "minLength": 1,
      "description": "Variable symbol."
    },
    "amount_to": {
      "type": "number",
      "maximum": 1000000000000,
      "minimum": 0,
      "description": "Maximum amount."
    },
    "client_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "Only documents of this client (superfaktura_list_clients).",
      "exclusiveMinimum": 0
    },
    "direction": {
      "enum": [
        "ASC",
        "DESC"
      ],
      "type": "string",
      "description": "Sort direction (default DESC)."
    },
    "created_to": {
      "type": "string",
      "description": "Issued on or before (yyyy-mm-dd)."
    },
    "invoice_no": {
      "type": "string",
      "maxLength": 40,
      "minLength": 1,
      "description": "Formatted document number, e.g. 2026001."
    },
    "amount_from": {
      "type": "number",
      "maximum": 1000000000000,
      "minimum": 0,
      "description": "Minimum amount."
    },
    "created_since": {
      "type": "string",
      "description": "Issued on or after (yyyy-mm-dd)."
    },
    "created_period": {
      "enum": [
        "all",
        "today",
        "yesterday",
        "this_week",
        "this_month",
        "last_month",
        "this_quarter",
        "last_quarter",
        "this_year",
        "last_year"
      ],
      "type": "string",
      "description": "Issue date as a period (default this_year when no date filter is given)."
    },
    "modified_period": {
      "enum": [
        "all",
        "today",
        "yesterday",
        "this_week",
        "this_month",
        "last_month",
        "this_quarter",
        "last_quarter",
        "this_year",
        "last_year"
      ],
      "type": "string",
      "description": "Last changed in this period."
    }
  }
}
    arguments 137 lines
  • superfaktura_get_invoice auth-required never probed

    One document (invoice, proforma, quote ...) with its header (number, dates, status, amounts, currency, symbols, comments), client, items, VAT summary, payments and related documents. The public access token and payment links of the document are not returned. GET /invoices/view/{id}.json.

    mcp-tool

    {
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "invoice_id"
  ],
  "properties": {
    "invoice_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "Invoice id (the id of a superfaktura_list_invoices row).",
      "exclusiveMinimum": 0
    }
  }
}
    arguments 15 lines
  • superfaktura_list_expenses auth-required never probed

    List received documents (expenses: received invoices, bills, internal documents) with amounts, VAT, supplier and payment status. status: issued (new), partially_paid, paid, overdue. Without a date filter SuperFaktura applies its default period; pass created_period='all' for everything. Paged: pass next_page as page. GET /expenses/index.json.

    mcp-tool

    {
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 100000,
      "minimum": 1,
      "description": "Page number, 1-based (default 1). Use next_page from the previous reply."
    },
    "type": {
      "enum": [
        "invoice",
        "bill",
        "contribution",
        "internal",
        "nondeductible",
        "recieved_credit_note"
      ],
      "type": "string",
      "description": "Expense type (note the vendor's spelling recieved_credit_note)."
    },
    "search": {
      "type": "string",
      "maxLength": 120,
      "minLength": 1,
      "description": "Text to search for (matched by SuperFaktura in names, numbers, e-mails ... of the records)."
    },
    "status": {
      "enum": [
        "issued",
        "partially_paid",
        "paid",
        "overdue"
      ],
      "type": "string",
      "description": "Payment status."
    },
    "per_page": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "Results per page, 1-100 (the account's profile default when omitted)."
    },
    "amount_to": {
      "type": "number",
      "maximum": 1000000000000,
      "minimum": 0
    },
    "client_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "Supplier (client) id.",
      "exclusiveMinimum": 0
    },
    "direction": {
      "enum": [
        "ASC",
        "DESC"
      ],
      "type": "string",
      "description": "Sort direction (default DESC)."
    },
    "created_to": {
      "type": "string",
      "description": "Issued on or before (yyyy-mm-dd)."
    },
    "amount_from": {
      "type": "number",
      "maximum": 1000000000000,
      "minimum": 0
    },
    "category_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "Expense category id (superfaktura_list_expense_categories).",
      "exclusiveMinimum": 0
    },
    "created_since": {
      "type": "string",
      "description": "Issued on or after (yyyy-mm-dd)."
    },
    "created_period": {
      "enum": [
        "all",
        "today",
        "yesterday",
        "this_week",
        "this_month",
        "last_month",
        "this_quarter",
        "last_quarter",
        "this_year",
        "last_year"
      ],
      "type": "string",
      "description": "Issue date as a period."
    }
  }
}
    arguments 100 lines
  • superfaktura_get_expense auth-required never probed

    One expense with its items, VAT rates, payments and supplier. Attachments are not returned. GET /expenses/view/{id}.json.

    mcp-tool

    {
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "expense_id"
  ],
  "properties": {
    "expense_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "Expense id (from superfaktura_list_expenses).",
      "exclusiveMinimum": 0
    }
  }
}
    arguments 15 lines
  • superfaktura_list_expense_categories auth-required never probed

    The expense category tree (id, name, parent) for the category_id of expenses. GET /expenses/expense_categories.

    mcp-tool

    {
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {}
}
    arguments 5 lines
  • superfaktura_list_bank_moves auth-required never probed

    Bank transactions imported into SuperFaktura (date, amount, currency, variable symbol, counter account, matching state), newest first by default. Filter by date range, credit/debit or amount. Paged: pass next_page as page. GET /accounts/index.json.

    mcp-tool

    {
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 100000,
      "minimum": 1,
      "description": "Page number, 1-based (default 1). Use next_page from the previous reply."
    },
    "search": {
      "type": "string",
      "maxLength": 120,
      "minLength": 1,
      "description": "Text to search for (matched by SuperFaktura in names, numbers, e-mails ... of the records)."
    },
    "date_to": {
      "type": "string",
      "description": "Transactions on or before (yyyy-mm-dd)."
    },
    "per_page": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "Results per page, 1-100 (the account's profile default when omitted)."
    },
    "amount_to": {
      "type": "number",
      "maximum": 1000000000000,
      "minimum": 0
    },
    "direction": {
      "enum": [
        "ASC",
        "DESC"
      ],
      "type": "string",
      "description": "Sort direction."
    },
    "move_type": {
      "enum": [
        "credit",
        "debit"
      ],
      "type": "string",
      "description": "credit = incoming, debit = outgoing."
    },
    "date_since": {
      "type": "string",
      "description": "Transactions on or after (yyyy-mm-dd)."
    },
    "amount_from": {
      "type": "number",
      "maximum": 1000000000000,
      "minimum": 0
    },
    "date_period": {
      "enum": [
        "all",
        "today",
        "yesterday",
        "this_week",
        "this_month",
        "last_month",
        "this_quarter",
        "last_quarter",
        "this_year",
        "last_year"
      ],
      "type": "string",
      "description": "Transaction date as a period."
    }
  }
}
    arguments 74 lines
  • superfaktura_list_cash_registers auth-required never probed

    The company's cash registers with currency, number of entries and current balance (read only). GET /cash_registers/getDetails.

    mcp-tool

    {
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {}
}
    arguments 5 lines
  • superfaktura_list_stock_items auth-required never probed

    List warehouse items (name, SKU, unit, price, VAT, quantity in stock). search matches name, SKU and description; sku matches the SKU. Paged: pass next_page as page. GET /stock_items/index.json.

    mcp-tool

    {
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "sku": {
      "type": "string",
      "maxLength": 60,
      "minLength": 1,
      "description": "Search by SKU."
    },
    "page": {
      "type": "integer",
      "maximum": 100000,
      "minimum": 1,
      "description": "Page number, 1-based (default 1). Use next_page from the previous reply."
    },
    "search": {
      "type": "string",
      "maxLength": 120,
      "minLength": 1,
      "description": "Text to search for (matched by SuperFaktura in names, numbers, e-mails ... of the records)."
    },
    "per_page": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "Results per page, 1-100 (the account's profile default when omitted)."
    },
    "price_to": {
      "type": "number",
      "maximum": 1000000000000,
      "minimum": 0
    },
    "direction": {
      "enum": [
        "ASC",
        "DESC"
      ],
      "type": "string",
      "description": "Sort direction."
    },
    "price_from": {
      "type": "number",
      "maximum": 1000000000000,
      "minimum": 0
    },
    "in_stock_only": {
      "type": "boolean",
      "description": "true = only items that are in stock."
    }
  }
}
    arguments 52 lines
  • superfaktura_list_stock_movements auth-required never probed

    The stock log of one item (quantity changes, notes, related invoice or expense). Paged: pass next_page as page. GET /stock_items/movements/{id}.

    mcp-tool

    {
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "stock_item_id"
  ],
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 100000,
      "minimum": 1,
      "description": "Page number, 1-based (default 1). Use next_page from the previous reply."
    },
    "per_page": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "Results per page, 1-100 (the account's profile default when omitted)."
    },
    "direction": {
      "enum": [
        "ASC",
        "DESC"
      ],
      "type": "string",
      "description": "Sort direction (default ASC)."
    },
    "stock_item_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "Stock item id.",
      "exclusiveMinimum": 0
    }
  }
}
    arguments 35 lines
  • superfaktura_list_sequences auth-required never probed

    The document numbering sequences per document type (id, name, mask, next formatted number, default flag); sequence ids are used when creating documents. GET /sequences/index.json.

    mcp-tool

    {
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {}
}
    arguments 5 lines
  • superfaktura_get_response_by_checksum auth-required never probed

    If a superfaktura_create_invoice call timed out, fetch the reply of the ORIGINAL request by the checksum it was sent with (kept 3 months), so the document is not created twice. GET /api_logs/getResponseByChecksum/{checksum}.

    mcp-tool

    {
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "checksum"
  ],
  "properties": {
    "checksum": {
      "type": "string",
      "pattern": "^[A-Za-z0-9._-]{1,32}$",
      "description": "The checksum given to superfaktura_create_invoice."
    }
  }
}
    arguments 14 lines
  • superfaktura_create_client auth-required never probed

    WRITE: adds a new client to the SuperFaktura address book (only the name is required). Nothing is sent to the client. Not idempotent: calling twice creates two clients, so check superfaktura_list_clients first. POST /clients/create.

    mcp-tool

    {
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "name"
  ],
  "properties": {
    "dic": {
      "type": "string",
      "maxLength": 40,
      "description": "Tax id (DIČ, Slovak)."
    },
    "ico": {
      "type": "string",
      "maxLength": 40,
      "description": "Company id (IČO)."
    },
    "zip": {
      "type": "string",
      "maxLength": 20
    },
    "city": {
      "type": "string",
      "maxLength": 255
    },
    "iban": {
      "type": "string",
      "maxLength": 40
    },
    "name": {
      "type": "string",
      "maxLength": 255,
      "minLength": 1,
      "description": "Client name (company or person)."
    },
    "email": {
      "type": "string",
      "pattern": "^[^\\s@]+@[^\\s@]+$",
      "maxLength": 254,
      "description": "Client e-mail (stored only; nothing is sent to it)."
    },
    "phone": {
      "type": "string",
      "maxLength": 40
    },
    "swift": {
      "type": "string",
      "maxLength": 20
    },
    "ic_dph": {
      "type": "string",
      "maxLength": 40,
      "description": "VAT id (IČ DPH in Slovakia, DIČ in the Czech Republic)."
    },
    "address": {
      "type": "string",
      "maxLength": 255,
      "description": "Street and number."
    },
    "comment": {
      "type": "string",
      "maxLength": 2000,
      "description": "Internal note on the client."
    },
    "country_id": {
      "type": "integer",
      "maximum": 1000,
      "description": "Country id (superfaktura_list_countries); Slovakia is 191. Defaults to the instance's country.",
      "exclusiveMinimum": 0
    }
  }
}
    arguments 72 lines
  • superfaktura_add_contact_person auth-required never probed

    WRITE: adds a contact person (name and e-mail, optional phone) to an existing client. Nothing is sent to that person. Not idempotent. POST /contact_people/add/api:1.

    mcp-tool

    {
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "client_id",
    "name",
    "email"
  ],
  "properties": {
    "name": {
      "type": "string",
      "maxLength": 255,
      "minLength": 1,
      "description": "Contact person's name."
    },
    "email": {
      "type": "string",
      "pattern": "^[^\\s@]+@[^\\s@]+$",
      "maxLength": 254,
      "description": "Contact person's e-mail (stored only)."
    },
    "phone": {
      "type": "string",
      "maxLength": 40
    },
    "client_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "Existing client id.",
      "exclusiveMinimum": 0
    }
  }
}
    arguments 33 lines
  • superfaktura_create_tag auth-required never probed

    WRITE: adds a new tag name (usable on invoices, expenses and clients in the SuperFaktura app). A duplicate name is refused by SuperFaktura. POST /tags/add.

    mcp-tool

    {
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "maxLength": 100,
      "minLength": 1,
      "description": "Tag name."
    }
  }
}
    arguments 15 lines
  • superfaktura_create_expense auth-required never probed

    WRITE: records a received document (expense) with ONE total amount and VAT rate, e.g. a supplier invoice or a bill. It is created unpaid: no payment is recorded and nothing is sent. No attachments. Not idempotent: calling twice records two expenses. POST /expenses/add.

    mcp-tool

    {
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "name",
    "amount"
  ],
  "properties": {
    "due": {
      "type": "string",
      "description": "Due date (default today)."
    },
    "vat": {
      "type": "number",
      "maximum": 100,
      "minimum": 0,
      "description": "VAT rate in percent (default 0)."
    },
    "name": {
      "type": "string",
      "maxLength": 250,
      "minLength": 1,
      "description": "Expense name / what it is for."
    },
    "type": {
      "enum": [
        "invoice",
        "bill",
        "internal",
        "nondeductible"
      ],
      "type": "string",
      "description": "Expense type (default invoice = received invoice)."
    },
    "amount": {
      "type": "number",
      "maximum": 1000000000000,
      "minimum": -1000000000000,
      "description": "Amount WITHOUT VAT."
    },
    "comment": {
      "type": "string",
      "maxLength": 2000,
      "description": "Comment."
    },
    "created": {
      "type": "string",
      "description": "Issue date (default today)."
    },
    "currency": {
      "type": "string",
      "pattern": "^[A-Z]{3}$",
      "description": "3-letter currency code, e.g. EUR, CZK."
    },
    "delivery": {
      "type": "string",
      "description": "Delivery date (default today)."
    },
    "variable": {
      "type": "string",
      "maxLength": 40,
      "description": "Variable symbol."
    },
    "client_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "Supplier (client) id from superfaktura_list_clients.",
      "exclusiveMinimum": 0
    },
    "category_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "Expense category id from superfaktura_list_expense_categories.",
      "exclusiveMinimum": 0
    },
    "document_number": {
      "type": "string",
      "maxLength": 60,
      "description": "The supplier's document number."
    }
  }
}
    arguments 82 lines
  • superfaktura_create_invoice auth-required never probed

    WRITE: creates ONE document in SuperFaktura for the user to review: type draft (concept, default), estimate (quote), order or proforma. A final regular invoice cannot be created here. It is NOT sent (no e-mail, no post), NOT marked paid or sent, and has no payment link or discount. Give an existing client_id (its name is read first with one extra GET /clients/view/{id}, so the call uses 2 requests of the daily quota) OR a new client's name (+ optional ico/dic/ic_dph/address...). Items: name, unit price without VAT, VAT rate, quantity. Not idempotent: pass a checksum (max 32 chars) so a timed-out call can be recovered with superfaktura_get_response_by_checksum instead of retried. POST /invoices/create.

    mcp-tool

    {
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "items"
  ],
  "properties": {
    "due": {
      "type": "string",
      "description": "Due date."
    },
    "name": {
      "type": "string",
      "maxLength": 250,
      "minLength": 1,
      "description": "Document title (default generated from the number)."
    },
    "type": {
      "enum": [
        "draft",
        "estimate",
        "order",
        "proforma"
      ],
      "type": "string",
      "description": "Document type: draft (default), estimate, order or proforma."
    },
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "name",
          "unit_price"
        ],
        "properties": {
          "tax": {
            "type": "number",
            "maximum": 100,
            "minimum": 0,
            "description": "VAT rate in percent, e.g. 20 (use 0 when the company is not a VAT payer)."
          },
          "name": {
            "type": "string",
            "maxLength": 250,
            "minLength": 1,
            "description": "Item name."
          },
          "unit": {
            "type": "string",
            "maxLength": 20,
            "description": "Unit, e.g. ks, h, m."
          },
          "quantity": {
            "type": "number",
            "maximum": 1000000000,
            "description": "Quantity (default 1).",
            "exclusiveMinimum": 0
          },
          "unit_price": {
            "type": "number",
            "maximum": 1000000000,
            "minimum": -1000000000,
            "description": "Unit price WITHOUT VAT (the full price when the company is not a VAT payer)."
          },
          "description": {
            "type": "string",
            "maxLength": 5000,
            "description": "Item description shown on the document."
          }
        }
      },
      "maxItems": 100,
      "minItems": 1,
      "description": "1-100 items."
    },
    "comment": {
      "type": "string",
      "maxLength": 5000,
      "description": "Comment on the document."
    },
    "created": {
      "type": "string",
      "description": "Issue date (default today)."
    },
    "checksum": {
      "type": "string",
      "pattern": "^[A-Za-z0-9._-]{1,32}$",
      "description": "Your own unique token (max 32 chars) to recover the reply if the call times out."
    },
    "constant": {
      "type": "string",
      "maxLength": 10,
      "description": "Constant symbol."
    },
    "delivery": {
      "type": "string",
      "description": "Delivery date."
    },
    "order_no": {
      "type": "string",
      "maxLength": 40,
      "description": "Order number."
    },
    "specific": {
      "type": "string",
      "maxLength": 20,
      "description": "Specific symbol."
    },
    "variable": {
      "type": "string",
      "maxLength": 40,
      "description": "Variable symbol (the document number when empty)."
    },
    "client_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "Existing client id (superfaktura_list_clients). Give this OR client_name.",
      "exclusiveMinimum": 0
    },
    "client_dic": {
      "type": "string",
      "maxLength": 40,
      "description": "Client tax id (DIČ), with client_name."
    },
    "client_ico": {
      "type": "string",
      "maxLength": 40,
      "description": "Client company id (IČO), with client_name."
    },
    "client_zip": {
      "type": "string",
      "maxLength": 20,
      "description": "Client ZIP, with client_name."
    },
    "client_city": {
      "type": "string",
      "maxLength": 255,
      "description": "Client city, with client_name."
    },
    "client_name": {
      "type": "string",
      "maxLength": 255,
      "minLength": 1,
      "description": "Name of a new/matching client (used when client_id is not given)."
    },
    "sequence_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "Numbering sequence id (superfaktura_list_sequences).",
      "exclusiveMinimum": 0
    },
    "client_email": {
      "type": "string",
      "pattern": "^[^\\s@]+@[^\\s@]+$",
      "maxLength": 254,
      "description": "Client e-mail, with client_name (stored only; nothing is sent)."
    },
    "client_ic_dph": {
      "type": "string",
      "maxLength": 40,
      "description": "Client VAT id, with client_name."
    },
    "client_address": {
      "type": "string",
      "maxLength": 255,
      "description": "Client street and number, with client_name."
    },
    "header_comment": {
      "type": "string",
      "maxLength": 5000,
      "description": "Comment above the items (shown on the document)."
    },
    "internal_comment": {
      "type": "string",
      "maxLength": 5000,
      "description": "Internal comment (not shown on the document)."
    },
    "invoice_currency": {
      "type": "string",
      "pattern": "^[A-Z]{3}$",
      "description": "3-letter currency code, e.g. EUR, CZK."
    },
    "client_country_id": {
      "type": "integer",
      "maximum": 1000,
      "description": "Client country id (superfaktura_list_countries), with client_name.",
      "exclusiveMinimum": 0
    }
  }
}
    arguments 191 lines
_ try it through the hub, ceiling 0

This deployment has no calling key, so nothing can be run from here. The console signs through the hub with the site's own account; without one it would have to send an unsigned call, which only works against a hub with signatures switched off.

_ is this your agent? claim it: badge, payouts, history

Nobody has claimed this listing. Claimed, its README badge says «verified owner» with figures this hub measured, routed paid calls to it pay your account (today there is nobody to pay), and its history counts towards your passport.

  1. Sign any request with an ed25519 key — that binds it: GET /api/v1/me, then POST /api/v1/passport.
  2. Prove it is yours. Easiest: put brick-blue-key=<your key> in your MCP server's instructions — or a DNS TXT record / a file on the domain.
  3. Ask the hub to check: POST /api/v1/passport/claim-endpoint with this listing's id 0a807113c3ddde05.

Every step, filled in for this listing: https://brick.blue/api/v1/agents/0a807113c3ddde05/claim. Over MCP: the claim_endpoint tool.

_ for your README measured, not declared

measured by brick.blue

[![measured by brick.blue](https://brick.blue/api/v1/agents/0a807113c3ddde05/badge.svg)](https://brick.blue/agent/0a807113c3ddde05?ref=badge)

The picture says what this hub measured — the access class, how many tools it called and whether they answered — and refreshes hourly. Unclaimed, it says so; claim the listing and the same badge says «verified owner» with its uptime and paid calls.

_ how we know
card completeness
100%

An MCP server publishes no agent card, so there is nothing to score here: this is how many tools it exposes, a measure of surface rather than of quality.

spec deviations
0

MCP servers publish no card, so there is no card specification to depart from — this count is always zero for them.

_ record

Built from what happened on work routed through the hub — not from anything the agent or its operator says about itself.

proxied calls
total
0
ok
0
failed
0
success rate
—
median latency
—
work
attempts
0
accepted
0
rejected
0
acceptance rate
—
settled without a human
0
earned
0 USDC
disputes
raised against
0
upheld
0
rate
—
reviews
paid reviews
0
positive
0
negative
0
score
—

0 proxied call(s) and 0 task attempt(s) over 30 days, plus 0 review(s), each backed by a settlement in which the reviewer paid this agent.

_ also on usefulapi.io 131 entries

Served from the same domain, which is what was measured. Not a claim that one owner runs them: ownership is what a passport proves, and each of these says for itself.

123 more sit on this domain. All of them.