TS Facturas MCP by usefulapi

io.usefulapiPublished by usefulapi.ioOfficial publisherv1.0.0Updated Nov 19, 2026

Read invoices, contacts, expenses and payments; create contacts and payments in TS Facturas.

The publisher's own server: Ably MCP by usefulapi

VerifiedStreamable HTTPWeb executableFinanceBusiness & Commerce

Overview

AI-generated overview

Hosted MCP server for TS Facturas that lets an assistant read invoices, expenses, contacts and payments, and create contacts, products and payments.

What you can do
  • Check the connected business account (ID, fiscal name, VAT number, role)
  • List and open invoices and sales receipts with lines, taxes, totals and status
  • List customers and suppliers, and expenses with their lines and totals
  • List payments by direction, method, date, contact or account
  • Create contacts, catalogue products and record incoming or outgoing payments
  • Report usage, request a missing feature, upgrade or cancel the paid plan
When to use it
Useful when you keep your invoicing and bookkeeping in TS Facturas and want an assistant to answer questions such as which issued invoices are still unpaid, or which supplier expenses fall in a given month, and to add customers, products or payments without opening the app.
Requirements
A remote endpoint reached over OAuth; no local install. You sign in with your TS Facturas credentials and, on first connect, provide the API client ID and API client secret generated in TS Facturas under Integraciones, API Pública. No keys go in the client config. A free plan allows 50 tool calls per month; paid plans are billed per user.
Before you install
The server stores your TS Facturas API client ID and secret per user, so treat them as sensitive. Three tools write to the business books (contacts, products, payments) and should be confirmed before use. Paid plans cost money: upgrades return a Stripe Checkout link, plan changes charge the price difference immediately, and cancellation gives no refund for the current period. Your invoice and contact data is sent to the hosted service.

Installation

In SourceWeft

  1. Open TS Facturas MCP by usefulapi in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.usefulapi%2Fts-facturas/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "ts-facturas-by-usefulapi": {
      "type": "http",
      "url": "https://ts-facturas.usefulapi.io/mcp"
    }
  }
}

README

TS Facturas MCP by usefulapi

Use your TS Facturas account from Claude, Cursor, or any MCP client. Read invoices, expenses, contacts and payments, and create contacts, products and payments. Hosted, no local install: connect with your own credentials.

Live endpoint: https://ts-facturas.usefulapi.io/mcp · Homepage: https://usefulapi.io

Connect

  • Claude (claude.ai, Desktop): open Customize → Connectors, click + Add → Add custom connector, and paste https://ts-facturas.usefulapi.io/mcp.
  • Claude Code: claude mcp add --transport http ts-facturas https://ts-facturas.usefulapi.io/mcp, then run /mcp to log in.
  • VS Code: Add to VS Code.
  • Cursor and other clients: add the URL as a remote MCP server:
json
{  "mcpServers": {    "ts-facturas": {      "url": "https://ts-facturas.usefulapi.io/mcp"    }  }}

Add only the URL. Do not add an Authorization header or an API key to the client config: the server signs you in with OAuth, and the login page asks for your TS Facturas credentials.

Step-by-step setup, where to find your credentials, and FAQ: https://usefulapi.io/ts-facturas/

On first connect you provide the API client ID and API client secret of your business (TS Facturas → Integraciones → API Pública → Generar credenciales). The server validates it and stores it per user. No keys go in config files.

Tools

ToolTypeWhat it does
tsfacturas_get_accountreadGet account
tsfacturas_list_invoicesreadList invoices
tsfacturas_get_invoicereadGet invoice
tsfacturas_list_contactsreadList contacts
tsfacturas_list_expensesreadList expenses
tsfacturas_list_paymentsreadList payments
tsfacturas_create_contactwriteCreate contact
tsfacturas_create_productwriteCreate product
tsfacturas_create_paymentwriteCreate payment
tsfacturas_usage_statusmetaUsage status (free-tier meter)
tsfacturas_request_featuremetaRequest a missing feature
tsfacturas_upgrademetaUpgrade to Pro or Pro+
tsfacturas_cancel_subscriptionmetaCancel the Pro subscription

read tools are read-only; write tools mutate data (clients should confirm them); meta tools report usage, manage your subscription or send a feature request.

Pricing

PlanPriceLimit
Free$050 tool calls / month
Pro (per user)$9/mo or $90/yr (2 months free)10,000 tool calls / month
Pro+ (per user)$39/mo or $390/yr (2 months free)100,000 tool calls / month

Each paid plan covers this server only. Ask your AI to run tsfacturas_upgrade and choose Pro or Pro+, billed monthly or yearly (it returns a Stripe Checkout link). If you already have Pro, ask to change it to Pro+. The change requires your confirmation, keeps your billing interval and charges the price difference for the rest of the period immediately. Cancel any time with tsfacturas_cancel_subscription: your paid plan continues to the end of the paid period, with no refund for the current period, and asking to resume the same plan with tsfacturas_upgrade before then undoes the cancel. Or write to [email protected].

License

MIT — see LICENSE. Documentation only; the server is hosted.

Source: servers/ts-facturas/README.md at commit 4f71a0d

Tools

9

tsfacturas_get_account

Get account

Show the business this API client belongs to: business ID, fiscal name, VAT number and role. Good first call to check the connection. TS Facturas API: GET /v1/auth/info.

Takes no parameters.

tsfacturas_list_invoices

List invoices

List invoices and sales receipts with status, totals, dates and contact. Filter by status, date range, customer VAT number or paid state. Use the id from here with tsfacturas_get_invoice. TS Facturas API: GET /v1/invoices.

Parameterslimitoffsetstatusis_paidissued_toreferenceissued_fromserial_codedocument_typesort_issued_datecontact_vat_number

tsfacturas_get_invoice

Get invoice

Get one invoice or sales receipt with its lines, taxes, totals, contact and status. TS Facturas API: GET /v1/invoices/{id}.

Parametersinvoice_idrequired

tsfacturas_list_contacts

List contacts

List customers and providers (contacts) with fiscal name, VAT number and contact details. Filter by exact VAT number or customer/provider role. TS Facturas API: GET /v1/contacts.

Parameterslimitoffsetvat_numberis_customeris_providersort_fiscal_name

tsfacturas_list_expenses

List expenses

List expenses (purchase documents) with identifier, date, contact, lines and totals. Filter by date range, identifier, paid state or supplier VAT number. TS Facturas API: GET /v1/expenses.

Parameterslimitoffsetis_paidissued_toidentifierissued_fromsort_issued_datecontact_vat_number

tsfacturas_list_payments

List payments

List payments with date, amount, method, direction (income or expense) and the contact or accounting account. Filter by direction, method, date range, contact or account. TS Facturas API: GET /v1/payments.

Parameterstypelimitmethodoffsetcontact_idoperation_tooperation_fromsort_operation_dateaccounting_account_id

tsfacturas_create_contact

Create contact

Create a customer or provider (contact) in the business. Writes a new record to the business books. TS Facturas API: POST /v1/contacts.

Parametersemailnotesphonevat_numberfiscal_namerequiredis_customeris_providervat_number_type

tsfacturas_create_product

Create product

Create a product or service in the business catalogue with its tax key and prices. Writes a new record to the business books. TS Facturas API: POST /v1/products.

Parametersnamerequiredtax_keyrequiredreferencedescriptionbuying_priceretail_priceselling_pricediscount_percentage

tsfacturas_create_payment

Create payment

Record a payment in the business books: income received or expense paid. Give exactly one of contact_id or document_id. Writes a new record. TS Facturas API: POST /v1/payments.

Parameterstyperequiredamountrequiredmethodrequiredcontact_iddescriptiondocument_idoperation_daterequired

Version history

1
  1. v1.0.0LatestNov 19, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

Other Usefulapi integrations