Integration

Invoka integration

Invoka issues Ecuador SRI electronic tax documents: invoices, credit and debit notes, remission guides, purchase settlements and withholding receipts (version 2.0, the one the ATS requires). These are legal tax documents filed with the SRI in production; a free test environment exists. Track a document's status, download its authorized XML and PDF (RIDE), reprocess or correct a rejected one, look up taxpayers by RUC, cedula or name in the SRI and Civil Registry records (personal data), read the credit balance and history, register companies and their logo, and manage the account's webhook. Left out: Invoka ID (private beta), the electronic-signature distributor routes, the signing-certificate upload, SMTP settings and the deprecated withholding 1.0 route. Authentication is the account API key (Invoka panel, Perfil), sent in the X-API-KEY header; 300 requests per minute per key.

Connect Invoka How integrations work

Ask it in chat

Say what should happen.
The workflow builds itself.

When this happens, do that in Invoka.Built from the 29 Invoka tools below, on the connection you add once.

What you can do with Invoka

Each of these is one operation on one endpoint, available both as a workflow step and as a tool an AI agent can call on its own. Nothing bundles several operations into one action, so what a run did stays readable afterwards.

Each badge shows the default agent permission of an endpoint (allowed: an agent calls it without asking; ask first: you are asked before an agent calls it, when the agent or chat asks permission for sensitive actions; never: no agent may call it), which every user can change endpoint by endpoint in their credential settings.

Most endpoints run on the free plan. A few, mainly the ones that publish on your behalf, need a paid plan.

Webhook, 4 operations

delete_webhookDelete webhookDELETEAgents: ask firstDeletes the account's webhook: Invoka stops posting document notices until save_webhook sets one again.
get_webhookGet webhookGETAgents: ask firstReturns the account's webhook: webhook_url, activo, eventos and ultimas_entregas (recent delivery attempts with event, access key, attempt, HTTP code and time). The signing secret is not returned.
save_webhookSave webhookPOSTAgents: ask firstSets the account's single webhook URL (replacing any previous one) for comprobante.autorizado and comprobante.error notices. Pass your own secret (16+ characters) to verify signatures: this tool does not return it.
test_webhookTest webhookPOSTAgents: ask firstQueues a signed webhook.prueba test notice to the account's webhook URL; its result (your server's HTTP code) shows in get_webhook's ultimas_entregas a few seconds later. Answers 422 when no webhook is set.

Taxpayer, 3 operations

lookup_identificationLookup identificationGETAgents: ask firstLooks up a cedula (10 digits, Civil Registry) or a RUC (13 digits, SRI register), detected from the length; data holds the matching record. Returns personal data for people; billed after 20 free lookups a month.
lookup_rucLookup rucGETAgents: ask firstLooks up a 13-digit RUC in the SRI register: name, taxpayer type, regime, status, accounting and withholding flags, activity, dates and every establishment. Billed after 20 free lookups a month. A person's RUC is personal data.
search_taxpayers_by_nameSearch taxpayers by nameGETAgents: ask firstSearches the SRI register for taxpayers whose legal or trade name contains a text (3+ characters): RUC, status, regime, type, activity and legal representatives. Billed after 20 free lookups a month.

Company, 2 operations

create_companyCreate companyPOSTAgents: ask firstRegisters an issuer company (RUC and legal name, plus tax flags) in the Invoka account so documents can be issued for it. Its signing certificate and SMTP settings are set in the Invoka panel.
update_companyUpdate companyPUTAgents: ask firstUpdates an issuer company identified by its RUC. Send ruc, razon_social and only the fields to change; the vendor's own integration sends just the changed fields. Same rules as create_company.

Document, 2 operations

correct_documentCorrect documentPOSTAgents: ask firstReplaces the data of a document the SRI returned or refused and processes it again with the same sequential number and access key. Pass the full corrected issue body in datos. No extra credit is charged.
reprocess_documentReprocess documentPOSTAgents: ask firstRe-queues a document stuck in a temporary state (SRI unavailable, processing) or fixed on the SRI side (a closed establishment). A document refused for its structure or a repeated sequential does not change: use correct_document.

Api, 1 operation

pingPingPOSTAgents: ask firstChecks that the Invoka API answers ({pong: true}). It does not validate the API key: use get_credit_balance to check a key.

Company logo, 1 operation

upload_company_logoUpload company logoPOSTAgents: ask firstUploads the logo printed on a company's documents (PDF RIDE): a PNG, JPG or JPEG image of at most 2 MB, for the company named by its RUC.

Credit balance, 1 operation

get_credit_balanceGet credit balanceGETAgents: ask firstReturns the account's billing credits: creditos_disponibles and estado_saldo (suficiente, bajo or agotado). One credit pays for one document authorized in production; the test environment is free.

Credit note, 1 operation

issue_credit_noteIssue credit notePOSTAgents: ask firstIssues a legal SRI credit note (code 04) that voids or adjusts an invoice already issued. Asynchronous: returns claveacceso; poll get_document_status. ambiente 2 is real and costs 1 credit once authorized.

Credit price, 1 operation

calculate_credits_for_amountCalculate credits for amountGETAgents: ask firstCalculates how many billing credits a top-up amount buys (no API key needed): pass amount in USD including VAT; returns the subtotal, VAT, credits and the tier applied.

Credit transaction, 1 operation

list_credit_historyList credit historyGETAgents: ask firstLists the account's credit transactions (consumption, top-ups, rollbacks), page by page. Filter by tipo and ambiente; limit up to 100 per page.

Debit note, 1 operation

issue_debit_noteIssue debit notePOSTAgents: ask firstIssues a legal SRI debit note (code 05) adding charges to an invoice (late interest, fees). Asynchronous: returns claveacceso; poll get_document_status. ambiente 2 is real and costs 1 credit once authorized.

Document pdf, 1 operation

download_document_pdfDownload document pdfGETAgents: ask firstDownloads a document's PDF (RIDE) and returns it as a stored file. In the test environment it carries a watermark. Answers 409 while the document is not authorized yet.

Document status, 1 operation

get_document_statusGet document statusGETAgents: ask firstReturns a document's current status: autorizado true once the SRI authorized it, requiere_correccion with errores when it was refused, en_proceso while processing, and xml / pdf links once authorized. Poll after an issue_* call.

Document xml, 1 operation

download_document_xmlDownload document xmlGETAgents: ask firstReturns the SRI-authorized XML of a document as text. Answers 409 while the document is not authorized yet (check get_document_status first).

Invoice, 1 operation

issue_invoiceIssue invoicePOSTAgents: ask firstIssues a legal SRI electronic invoice (code 01) for an issuer company to a buyer. Asynchronous: returns creado and claveacceso; poll get_document_status. ambiente 2 is real and costs 1 credit once authorized.

Person, 1 operation

lookup_cedulaLookup cedulaGETAgents: ask firstLooks up a 10-digit Ecuadorian cedula (national id) in the Civil Registry: the person's full official name, its parts, and date of death if any. Returns personal data; billed after 20 free lookups a month.

Pricing tier, 1 operation

list_pricing_tiersList pricing tiersGETAgents: ask firstLists the credit price tiers (no API key needed): top-up amount range in USD, price per credit with and without VAT, discount and credit range of each tier.

Purchase settlement, 1 operation

issue_purchase_settlementIssue purchase settlementPOSTAgents: ask firstIssues a legal SRI purchase settlement (liquidacion de compra, code 03) for a purchase from a supplier who cannot invoice. Asynchronous: returns claveacceso; poll get_document_status. ambiente 2 costs 1 credit once authorized.

Remission guide, 1 operation

issue_remission_guideIssue remission guidePOSTAgents: ask firstIssues a legal SRI remission guide (code 06) that documents moving goods: carrier, recipient, route and items. Asynchronous: returns claveacceso; poll get_document_status. ambiente 2 costs 1 credit once authorized.

Service status, 1 operation

get_service_statusGet service statusGETAgents: ask firstReturns the status of Invoka's services (no API key needed): overall_status (operational, degraded or major_outage) and each service's status, uptime and response time, plus active incidents.

Taxpayer establishment, 1 operation

list_ruc_establishmentsList ruc establishmentsGETAgents: ask firstLists the establishments (head office and branches) registered with the SRI for a 13-digit RUC: code, trade name, type, open or closed, and address. Billed after 20 free lookups a month.

Withholding receipt, 1 operation

issue_withholding_receiptIssue withholding receiptPOSTAgents: ask firstIssues a legal SRI withholding receipt version 2.0 (code 07, the one the ATS requires) on a supplier's document. Asynchronous: returns claveacceso; poll get_document_status. ambiente 2 costs 1 credit once authorized.

Use Invoka from Claude Code, Cursor or Codex

Connect Invoka in LiveContext, create an API key in Settings, then add the LiveContext MCP server to your client. Its Invoka operations become tools the client can call, next to every other integration you connected.

Claude Code

claude mcp add --transport http livecontext https://livecontext.ai/mcp --header "X-API-Key: YOUR_API_KEY"

Codex (~/.codex/config.toml)

[mcp_servers.livecontext]
url = "https://livecontext.ai/mcp"

[mcp_servers.livecontext.http_headers]
"X-API-Key" = "YOUR_API_KEY"

Cursor, Claude Desktop and other JSON configs

{
  "mcpServers": {
    "livecontext": {
      "type": "http",
      "url": "https://livecontext.ai/mcp",
      "headers": {
        "X-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

Set up the MCP server step by step

How to connect Invoka

Create your workspace
Sign up free. Nothing to install.
Connect Invoka once
Add your Invoka connection in Settings. Every tool from this integration reuses it, and secrets are encrypted at rest and visible only to you.
Describe the job in chat
The workflow builds itself in front of you and picks the endpoints it needs. Drag the steps yourself on the canvas whenever you would rather be explicit.