feat: add SuperFrete MCP server - #3
Conversation
Add MCP server for SuperFrete — Brazilian shipping platform with discounted rates across multiple carriers (PAC, SEDEX, JadLog, Loggi, Mini Envios). Tools: calculate_freight, create_freight, get_freight, checkout_freight, cancel_freight, get_user_info, get_user_addresses, get_services, list_webhooks, create_webhook, delete_webhook. Includes server-level instructions to guide AI agents through the typical freight workflow and input requirements. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Second P0-B server from the MCP expansion plan. Getnet is Santander-owned — #3 BR acquirer and #1 BR ecommerce per Santander IR. Together with Cielo, Stone, and Efi, this closes three of the "big four" BR acquirer quadrant. Distinct from per-PSP servers (Zoop, Pagar.me, Asaas, PagSeguro): Getnet is an acquirer, so merchants with a Santander commercial contract integrate directly instead of via a PSP. Different target customer; different business contract. Tools (11) authorize_credit authorize card (delayed=true) or auth+capture (false) capture_credit capture a prior authorization cancel_credit cancel authorized-but-uncaptured refund_credit full or partial refund create_pix Pix charge returning QR image + EMV copy-paste create_boleto bank boleto with instruction text + expiration get_payment retrieve any payment by id tokenize_card PCI-safe card tokenization for reuse create_seller onboard marketplace seller (Marketplace Management) get_seller seller by id list_sellers paginated list with filters Authentication OAuth 2.0 Client Credentials. POST /auth/oauth/v2/token returns a bearer token. The server caches it in memory until 60s before expiry, transparent to callers. Every API call also includes seller_id header for tenant scoping. Why Getnet first (after dLocal) - No blocking product decision (Braspag waits on Cielo-boundary naming; Chargebee has fork-vs-native open; Matera needs mTLS sandbox; Adyen is a bigger multi-API scope) - Closes a concrete quadrant gap: three of four big BR acquirers in the catalog - Marketplace seller onboarding is a first-class API, unusual for acquirers at this tier Build verified (tsc 0 errors, dist/index.js emitted). Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
|
Hi @andreabadesso — sorry for the very long silence on this, and thanks for the patience. The SuperFrete server itself looks clean: 11 well-shaped tools, sandbox/prod env switch, proper bearer auth, and the inline workflow guidance you put in The PR can't merge as-is only because the base branch is from a moment when the repo was still scoped to Brazil — since then the catalog has been renamed/expanded (LATAM) and ~80 new servers have landed, so the diff vs current To unblock this without asking you to redo work, I'm going to:
Will follow up here once the rebase is up. Thanks again for contributing. |
* feat: add SuperFrete MCP server with 11 tools Add MCP server for SuperFrete — Brazilian shipping platform with discounted rates across multiple carriers (PAC, SEDEX, JadLog, Loggi, Mini Envios). Tools: calculate_freight, create_freight, get_freight, checkout_freight, cancel_freight, get_user_info, get_user_addresses, get_services, list_webhooks, create_webhook, delete_webhook. Includes server-level instructions to guide AI agents through the typical freight workflow and input requirements. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com> * chore(superfrete): align with project conventions Adjustments on top of the SuperFrete contribution to satisfy audit-catalog and the catalog's standard server shape: - src/index.ts: prepend MANAGED_TIER_HINT to the instructions block (kept the contributor's SuperFrete workflow guidance afterward — agents get both the project-wide managed-tier pointer + the API flow hints in one place). - server.json: add the MCP registry entry (schema + provider + environmentVariables) so the server is listable. - package.json: add mcpName for registry ownership verification. - README.md (server): convert "## Tools" → "## Tools (11)" for the audit's tool-count consistency check, add the Enterprise CTA section before License, and refresh the dangling MCP Dev Brasil / /mcp landing links to the current LATAM / /servers URLs. - README.md (root): bump the e-commerce table from 6 → 7 servers (SuperFrete row) and the top counters from 109/2,289 → 110/2,300. Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com> * fix(mercado-pago): exclude src/__tests__ from tsc build Follow-up to #173. The contract test imports from `test-utils/contract.js` at the repo root, which is outside mercado-pago's `rootDir: "./src"` and triggers TS6059 / TS1470 during `npm run build --workspaces --if-present` (the workspace build that gates CI). Vitest transpiles in-memory so the local `vitest run` we relied on for #173 didn't surface this. Excluding `src/__tests__` from the tsc include set keeps the build clean without changing how vitest resolves tests at the repo root. Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com> --------- Co-authored-by: André Abadesso <andre.abadesso@gmail.com> Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
|
Hi @andreabadesso — your SuperFrete contribution has shipped via #211 (merged at commit Since your fork was deleted at some point in the 3 months between this PR and today, I couldn't force-push the rebase back to your branch the usual way — so I opened #211 from a maintainer branch carrying your commit + a small follow-up that aligns the server with the catalog conventions that landed after April (managed-tier hint prefix, Closing this PR as superseded by #211. Thanks again for the contribution — sorry the silence was so long. |
Summary
Test plan
tsc— zero errors🤖 Generated with Claude Code