Sage Business Cloud Accounting

This connector wraps the Sage Business Cloud Accounting API v3.1 (api.accounting.sage.com). You authorize it once, in AnythingMCP; from then on the access token (5 minutes) is renewed automatically, and the refresh token Sage replaces on every renewal is stored for you.

Setup — OAuth2:

1. Register at https://developer.sage.com/accounting → Create app.
2. In the app, add this callback URL: https://cloud.anythingmcp.com/api/mcp-oauth/callback on AnythingMCP Cloud, or <your AnythingMCP server URL>/api/mcp-oauth/callback when you host AnythingMCP yourself.
3. Enter the app's client ID and client secret as SAGE_CLIENT_ID and SAGE_CLIENT_SECRET, leave SAGE_REFRESH_TOKEN empty, and install.
4. Open the connector and click Authorize with Provider. Sign in to Sage, pick the business, approve, and you land back on the connector page with the tools ready.

Scopes: the connector asks for full_access, which sage_create_contact needs. For a read-only connector, set the scope to readonly in the connector's OAuth settings before you authorize.

Already have a refresh token? You can paste it into SAGE_REFRESH_TOKEN instead of step 4. Sage replaces the refresh token every time it is used, so paste one you have not used yet: a token you already exchanged by hand (for example with curl to test it) is refused with invalid_grant. The token Sage returned from that exchange is the one to paste.

Authentication: OAuth2 — engine handles refresh. Sends Authorization: Bearer ${ACCESS_TOKEN}.

Business ID header: Sage scopes everything to a business. Pass X-Business: <BUSINESS_ID> header on each call OR rely on the default business of the user. To discover IDs: GET /v3.1/businesses.

Pagination: page (1-based) + items_per_page (max 200).

Rate limits: 100 req/min per token, 10k/day. 429 with Retry-After.

Out of scope here: VAT return submission, Stripe-connect setup, multi-currency journal lines beyond standard, asset register.