Repository navigation
Add 15 catalog adapters and fill gaps in 19 existing ones - #1233
Merged
Merged
Conversation
New adapters, each built from the vendor's public API documentation, with instructions, envVarMeta, verify hints, a read-only probe where the API allows one, a logo and a live spec gated behind RUN_<SLUG>_LIVE=1: - BlockCypher: Bitcoin, Litecoin, Dogecoin and Ethereum chain data (keyless, optional token) - Helius: Solana RPC, DAS assets, enhanced transactions and the Wallet API - Tabby, Tamara, noon payments: BNPL and card payment lookups; captures, refunds and closes install switched off - T-Bank Business: company, accounts, statements, documents and acquiring terminals, read-only; self-host only because the API presents a Russian Trusted Root CA certificate that Node does not trust by default - Checko: Russian company, entrepreneur and person registry data - Falco: Belgian purchase and sale documents, Peppol inbound and participant lookup; payment status and Peppol responses install switched off - Invoice123: invoices, purchases, PDFs and reference data, read-only - XOVI: SEO credits, rankings, OVI trend and keyword monitoring - Netskope: REST API v2 alerts, events, audit, URL lists, publishers, private apps and SCIM users/groups, read-only - SAP Sales Cloud and Service Cloud (C4C): OData v2 ready lists plus the generic OData tools - Trybe: creators, performance and submissions; review actions switched off - Medmis: clinic branches, staff, appointments, patients, invoices, stock and check-ups; personal identifiers are removed from responses, writes are off - Tezga eKasa: fiscal documents, tax labels and bank transactions; receipts, refunds and master-data upserts install switched off
Endpoints that are documented by each vendor and needed in practice, but were not covered yet. Writes that move money, delete or reach a third party install switched off. - weclapp: party e-mail addresses, open items (list, payment state off), current user, property translations, stock movements, production orders; reference data also covers custom attribute definitions and serial numbers - Klardaten: VAT filings and data, extended clients, instance details, required services, metrics, logs, audit logs and webhooks (secrets removed) - JTL-FFN: announce an inbound delivery (off) - HR WORKS: working-time status, onboarding documents, delete working times (off) - Gmail: download an attachment - Etsy: shop transactions, listings by ids; every tool named in instructions - Telegram Bot: sticker sets; business_connection_id on every send tool - Zenhub: the generic GraphQL mutation and subscription tools install off, the query tool stays on - Weeek: remove a task from a project - Daftra: update and delete journals (off), journal categories, treasuries, invoice draft status (off) - Fatture in Cloud: F24 tax payments (asks for taxes:r) - Fortnox: create invoice (off), file attachments, inbox; the inbox scope is documented as opt-in so existing integrations can still authorize - Sportmonks: pre-match odds by market and by bookmaker - Tiendanube: product images - Magento: low-stock items and the guest cart flow (cart and order writes off) - Exercise.com: assessments, appointment packages, group calendars, user workout exercises, purchased items - Chatwoot: add, update and remove agents (off) - Printful: printfiles, webhooks - amoCRM: loss reasons Also: Trendyol instructions name all tools, and stray em dashes removed.
![github-advanced-security[bot]](https://avatars.githubusercontent.com/in/57789?s=60&v=4){kind=small}
8 of 14 tasks
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to subscribe to this conversation on GitHub.
Already have an account?
Sign in.
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Adds 15 catalog adapters for public vendor APIs (payments, crypto, finance, B2B SaaS) and fills gaps in 19 existing adapters, so these services work from the catalog without a hand-made connector. Every tool is built from the vendor's public API documentation (
docsUrlin each adapter). Writes that move money, send, delete or are hard to undo install switched off.Changes
New adapters (544 listed, up from 529; 25 keyless)
blockcypherheliustabbytamaranoon-paymentstbankselfHostOnlycheckoinvoice123netskopesap-c4ctrybemedmistezgafalcoxovitbankisselfHostOnly: T-Bank's API is served under the Russian Trusted Root CA, which the Cloud runtime does not trust; on a self-hosted instance it works withNODE_EXTRA_CA_CERTS(stated in the instructions).Extended adapters
weclapp(+7): open items, current user, property translations, stock movements, production orders, set party emails, set open-item payment state (off).klardaten(+12): extended client list, VAT filings and data, instance info/metrics/logs, audit logs, webhooks (all reads).magento(+10): low-stock items and the guest-cart checkout flow; cart writes and order placement off.daftra(+5),exercise-com(+5),fortnox(+5),hrworks(+4),tiendanube(+4),chatwoot(+3, agent management off),etsy(+2),printful(+2),sportmonks(+2),jtl-ffn(+1, off),amocrm(+1),gmail(+1),telegram-bot(+1),weeek(+1),fatture-in-cloud(+1).zenhub: the generic GraphQL mutation tool installs switched off (it can change anything the key's user can); instructions point to the schema tool and the typed writes.trendyol: instruction fix.fortnox: theinboxscope stays opt-in (instructions sayfortnox_list_inboxneeds it); adding it to the default scopes would make authorization fail for integrations that lack it.falco:falco_set_purchase_payment_statusinstalls switched off.CITATION.cff,glama.json,package.json,server.json; the README banner text also said 23 keyless adapters (stale before this PR), now 25.Type
Testing
Each new adapter has a
*.live.spec.tswith static assertions for every tool mapping; live parts are gated behindRUN_<SLUG>_LIVE=1and only read. Read-only tools were exercised against real accounts (GET requests only, response shapes checked) for: weclapp, klardaten, hrworks, telegram-bot, zenhub, sportmonks, tiendanube, exercise-com, printful, amocrm, blockcypher, helius, tabby, tamara, checko, falco, invoice123, xovi, sap-c4c, trybe, medmis, tezga. Some tools answered 403 for plan or token-rights reasons (helius wallet identity, falco customers/articles, some invoice123 and sap-c4c reads); the routes and auth were confirmed. Not live-checked: OAuth adapters (gmail, etsy, fortnox, fatture-in-cloud), noon-payments, netskope, tbank (CA chain, see above).Commands (repository root unless noted), after rebasing on
main(91598b4):node scripts/validate-adapters.mjs --warn: exit 0, no new warnings on the added tools.node scripts/regenerate-catalog.mjs: no diff.node scripts/adapter-count.mjs --check:OK: every quoted count equals 544 adapters (25 keyless, 8356 tools).packages/backend:npx jest src/adapters: 537 suites passed, 1 skipped; 18,049 tests passed, 1,557 skipped, 0 failed.packages/backend, before the rebase:npm run lint0 errors (11 pre-existing warnings; unrelatedeslint --fixrewrites reverted),npx tsc --noEmit -p tsconfig.jsonclean,npm test768 suites, 22,877 tests passed, 0 failed.Cloud and self-hosted: catalog adapters behave the same in both modes, except
tbank, which is hidden on Cloud (selfHostOnly).Checklist
npm test)Related Issues
Website guides for these adapters: HelpCode-ai/anythingmcp-website (branch
feat/guides-block-19).