1. Guides
Synci API
  • Overview
  • Guides
    • Authentication
    • Building OAuth apps
    • Managed apps
    • Webhooks
    • Pagination, filtering, and sorting
    • Errors
    • Rate limits
    • MCP: Connect AI assistants
    • Synci as a SimpleFIN provider
  • Synci API
    • Finance
      • Connections
        • List all financial connections
        • Create a new financial connection
        • Get financial connection
        • Delete financial connection
        • Disable financial connection
        • Reconfirm the consent of a financial connection
      • Accounts
        • List all financial accounts
        • Get financial account
        • Update financial account
        • Delete financial account
        • Bulk delete financial accounts
        • Sync financial account data
        • Reset financial account config to defaults
        • List all account balance entries
        • Get account balance entry
        • List account holdings
        • Get account holding
        • Get enrichment backfill status
      • Transactions
        • List all transactions
        • Create a new transaction
        • Get transaction
        • Update transaction
        • Delete transaction
        • Bulk delete transactions
      • Institutions
        • Get supported countries
        • List all supported institutions
        • Get supported institution
    • Destinations
      • YNAB Connections
        • YNAB Budgets
          • YNAB Budget Accounts
            • List all YNAB budget accounts
            • Get YNAB budget account
            • Delete YNAB budget account
          • List all YNAB budgets
          • List all YNAB budgets
          • List all YNAB budgets
          • List all YNAB budgets
          • List all YNAB budgets
          • List all YNAB budgets
          • List all YNAB budgets
          • List all YNAB budgets
          • List all YNAB budgets
          • List all YNAB budgets
          • List all YNAB budgets
          • List all YNAB budgets
          • List all YNAB budgets
          • List all YNAB budgets
          • List all YNAB budgets
          • List all YNAB budgets
          • List all YNAB budgets
          • List all YNAB budgets
          • List all YNAB budgets
          • List all YNAB budgets
          • List all YNAB budgets
          • List all YNAB budgets
          • List all YNAB budgets
          • List all YNAB budgets
          • List all YNAB budgets
          • List all YNAB budgets
          • List all YNAB budgets
          • List all YNAB budgets
          • List all YNAB budgets
          • List all YNAB budgets
          • List all YNAB budgets
          • List all YNAB budgets
          • List all YNAB budgets
          • List all YNAB budgets
          • Get YNAB budget
          • Get YNAB budget
          • Get YNAB budget
          • Get YNAB budget
          • Get YNAB budget
          • Get YNAB budget
          • Get YNAB budget
          • Get YNAB budget
          • Get YNAB budget
          • Get YNAB budget
          • Get YNAB budget
          • Get YNAB budget
          • Get YNAB budget
          • Get YNAB budget
          • Get YNAB budget
          • Get YNAB budget
          • Get YNAB budget
          • Get YNAB budget
          • Get YNAB budget
          • Get YNAB budget
          • Get YNAB budget
          • Get YNAB budget
          • Get YNAB budget
          • Get YNAB budget
          • Get YNAB budget
          • Get YNAB budget
          • Get YNAB budget
          • Get YNAB budget
          • Get YNAB budget
          • Get YNAB budget
          • Get YNAB budget
          • Get YNAB budget
          • Get YNAB budget
          • Get YNAB budget
          • Delete YNAB budget
          • Delete YNAB budget
          • Delete YNAB budget
          • Delete YNAB budget
          • Delete YNAB budget
          • Delete YNAB budget
          • Delete YNAB budget
          • Delete YNAB budget
          • Delete YNAB budget
          • Delete YNAB budget
          • Delete YNAB budget
          • Delete YNAB budget
          • Delete YNAB budget
          • Delete YNAB budget
          • Delete YNAB budget
          • Delete YNAB budget
          • Delete YNAB budget
          • Delete YNAB budget
          • Delete YNAB budget
          • Delete YNAB budget
          • Delete YNAB budget
          • Delete YNAB budget
          • Delete YNAB budget
          • Delete YNAB budget
          • Delete YNAB budget
          • Delete YNAB budget
          • Delete YNAB budget
          • Delete YNAB budget
          • Delete YNAB budget
          • Delete YNAB budget
          • Delete YNAB budget
          • Delete YNAB budget
          • Delete YNAB budget
          • Delete YNAB budget
          • Update YNAB budget
          • Update YNAB budget
          • Update YNAB budget
          • Update YNAB budget
          • Update YNAB budget
          • Update YNAB budget
          • Update YNAB budget
          • Update YNAB budget
          • Update YNAB budget
          • Update YNAB budget
          • Update YNAB budget
          • Update YNAB budget
          • Update YNAB budget
          • Update YNAB budget
          • Update YNAB budget
          • Update YNAB budget
          • Update YNAB budget
          • Update YNAB budget
          • Update YNAB budget
          • Update YNAB budget
          • Update YNAB budget
          • Update YNAB budget
          • Update YNAB budget
          • Update YNAB budget
          • Update YNAB budget
          • Update YNAB budget
          • Update YNAB budget
          • Update YNAB budget
          • Update YNAB budget
          • Update YNAB budget
          • Update YNAB budget
          • Update YNAB budget
          • Update YNAB budget
          • Update YNAB budget
        • List all YNAB connections
        • List all YNAB connections
        • List all YNAB connections
        • List all YNAB connections
        • List all YNAB connections
        • List all YNAB connections
        • List all YNAB connections
        • List all YNAB connections
        • List all YNAB connections
        • List all YNAB connections
        • List all YNAB connections
        • List all YNAB connections
        • List all YNAB connections
        • List all YNAB connections
        • List all YNAB connections
        • List all YNAB connections
        • List all YNAB connections
        • List all YNAB connections
        • List all YNAB connections
        • List all YNAB connections
        • List all YNAB connections
        • List all YNAB connections
        • List all YNAB connections
        • List all YNAB connections
        • List all YNAB connections
        • List all YNAB connections
        • List all YNAB connections
        • List all YNAB connections
        • List all YNAB connections
        • List all YNAB connections
        • List all YNAB connections
        • List all YNAB connections
        • List all YNAB connections
        • List all YNAB connections
        • Create new YNAB connection
        • Create new YNAB connection
        • Create new YNAB connection
        • Create new YNAB connection
        • Create new YNAB connection
        • Create new YNAB connection
        • Create new YNAB connection
        • Create new YNAB connection
        • Create new YNAB connection
        • Create new YNAB connection
        • Create new YNAB connection
        • Create new YNAB connection
        • Create new YNAB connection
        • Create new YNAB connection
        • Create new YNAB connection
        • Create new YNAB connection
        • Create new YNAB connection
        • Create new YNAB connection
        • Create new YNAB connection
        • Create new YNAB connection
        • Create new YNAB connection
        • Create new YNAB connection
        • Create new YNAB connection
        • Create new YNAB connection
        • Create new YNAB connection
        • Create new YNAB connection
        • Create new YNAB connection
        • Create new YNAB connection
        • Create new YNAB connection
        • Create new YNAB connection
        • Create new YNAB connection
        • Create new YNAB connection
        • Create new YNAB connection
        • Create new YNAB connection
        • Get YNAB connection
        • Get YNAB connection
        • Get YNAB connection
        • Get YNAB connection
        • Get YNAB connection
        • Get YNAB connection
        • Get YNAB connection
        • Get YNAB connection
        • Get YNAB connection
        • Get YNAB connection
        • Get YNAB connection
        • Get YNAB connection
        • Get YNAB connection
        • Get YNAB connection
        • Get YNAB connection
        • Get YNAB connection
        • Get YNAB connection
        • Get YNAB connection
        • Get YNAB connection
        • Get YNAB connection
        • Get YNAB connection
        • Get YNAB connection
        • Get YNAB connection
        • Get YNAB connection
        • Get YNAB connection
        • Get YNAB connection
        • Get YNAB connection
        • Get YNAB connection
        • Get YNAB connection
        • Get YNAB connection
        • Get YNAB connection
        • Get YNAB connection
        • Get YNAB connection
        • Get YNAB connection
        • Delete YNAB connection
        • Delete YNAB connection
        • Delete YNAB connection
        • Delete YNAB connection
        • Delete YNAB connection
        • Delete YNAB connection
        • Delete YNAB connection
        • Delete YNAB connection
        • Delete YNAB connection
        • Delete YNAB connection
        • Delete YNAB connection
        • Delete YNAB connection
        • Delete YNAB connection
        • Delete YNAB connection
        • Delete YNAB connection
        • Delete YNAB connection
        • Delete YNAB connection
        • Delete YNAB connection
        • Delete YNAB connection
        • Delete YNAB connection
        • Delete YNAB connection
        • Delete YNAB connection
        • Delete YNAB connection
        • Delete YNAB connection
        • Delete YNAB connection
        • Delete YNAB connection
        • Delete YNAB connection
        • Delete YNAB connection
        • Delete YNAB connection
        • Delete YNAB connection
        • Delete YNAB connection
        • Delete YNAB connection
        • Delete YNAB connection
        • Delete YNAB connection
        • Update YNAB connection
        • Update YNAB connection
        • Update YNAB connection
        • Update YNAB connection
        • Update YNAB connection
        • Update YNAB connection
        • Update YNAB connection
        • Update YNAB connection
        • Update YNAB connection
        • Update YNAB connection
        • Update YNAB connection
        • Update YNAB connection
        • Update YNAB connection
        • Update YNAB connection
        • Update YNAB connection
        • Update YNAB connection
        • Update YNAB connection
        • Update YNAB connection
        • Update YNAB connection
        • Update YNAB connection
        • Update YNAB connection
        • Update YNAB connection
        • Update YNAB connection
        • Update YNAB connection
        • Update YNAB connection
        • Update YNAB connection
        • Update YNAB connection
        • Update YNAB connection
        • Update YNAB connection
        • Update YNAB connection
        • Update YNAB connection
        • Update YNAB connection
        • Update YNAB connection
        • Update YNAB connection
        • Refresh YNAB connection
        • Refresh YNAB connection
        • Refresh YNAB connection
        • Refresh YNAB connection
        • Refresh YNAB connection
        • Refresh YNAB connection
        • Refresh YNAB connection
        • Refresh YNAB connection
        • Refresh YNAB connection
        • Refresh YNAB connection
        • Refresh YNAB connection
        • Refresh YNAB connection
        • Refresh YNAB connection
        • Refresh YNAB connection
        • Refresh YNAB connection
        • Refresh YNAB connection
        • Refresh YNAB connection
        • Refresh YNAB connection
        • Refresh YNAB connection
        • Refresh YNAB connection
        • Refresh YNAB connection
        • Refresh YNAB connection
        • Refresh YNAB connection
        • Refresh YNAB connection
        • Refresh YNAB connection
        • Refresh YNAB connection
        • Refresh YNAB connection
        • Refresh YNAB connection
        • Refresh YNAB connection
        • Refresh YNAB connection
        • Refresh YNAB connection
        • Refresh YNAB connection
        • Refresh YNAB connection
        • Refresh YNAB connection
      • Lunch Money Connections
        • Lunch Money Accounts
          • List all Lunch Money accounts
          • Get Lunch Money account
          • Delete Lunch Money account
        • List all Lunch Money connections
        • Create new Lunch Money connection
        • Get Lunch Money connection
        • Delete Lunch Money connection
        • Update Lunch Money connection
        • Refresh Lunch Money connection
      • Google Sheets Connections
        • Sheets
          • List destination spreadsheets for a connection
          • Register a destination spreadsheet
          • Get a destination spreadsheet
          • Update a destination spreadsheet
          • Delete a destination spreadsheet
          • List the worksheets (tabs) of a spreadsheet
          • Create a new worksheet (tab) in a spreadsheet
        • List all Google Sheets connections
        • Create new Google Sheets connection
        • Get Google Sheets connection
        • Delete Google Sheets connection
        • Update Google Sheets connection
        • Refresh Google Sheets connection
      • SimpleFIN Connections
        • List all SimpleFIN connections
        • Create new SimpleFIN connection
        • Get SimpleFIN connection
        • Update SimpleFIN connection
        • Delete SimpleFIN connection
        • Regenerate setup token
        • Revoke access credentials
        • List accounts observed syncing
      • Notion Connections
        • Databases
          • List destination databases for a connection
          • Register a destination database
          • Get a destination database
          • Update a destination database
          • Delete a destination database
        • List all Notion connections
        • Create new Notion connection
        • Get Notion connection
        • Delete Notion connection
        • Update Notion connection
        • Refresh Notion connection
        • Search pages shared with Synci
        • Search databases shared with Synci
    • Webhooks
      • List all webhook events
      • List all webhook endpoints
      • Create new webhook endpoint
      • Get webhook endpoint
      • Update webhook endpoint
      • Delete webhook endpoint
      • Test webhook endpoint
      • Rotate webhook secret
    • User
      • Get the authenticated user
    • Rules
      • Create a new rule
      • Preview a rule against transactions (dry-run)
      • Rule field catalog
      • List all rules
      • Get rule
      • Update rule
      • Delete rule
      • Attach rule to a financial account
      • Detach rule from financial account
      • Reorder rules for a financial account
      • Attach rule to transfer link
      • Detach rule from transfer link
      • Reorder rules for a transfer link
    • Rule Logs
      • List all rule logs
      • Get rule log
      • Undo multiple rule actions
      • Undo a rule action
    • Transfer Links
      • List all transfer links
      • Create a new transfer link
      • Get transfer link
      • Update transfer link
      • Delete transfer link
      • Retry transfers for all transfer links
      • Retry transfers for a specific transfer link
    • Transfer Logs
      • List all transfer logs
      • Get transfer log
      • Undo a transfer
      • Undo multiple transfers
  • Managed Apps API
    • Managed Users
      • List your users
      • Register a user
      • Get a user
      • Update a user
      • Delete a user
      • Mint a token pair
      • Create a portal session
    • Managed Connections
      • List your users' financial connections
    • Managed Webhooks
      • List webhook events
      • List your webhook endpoints
      • Register a webhook endpoint
      • Show a webhook endpoint
      • Update a webhook endpoint
      • Delete a webhook endpoint
      • Send a test delivery
      • Rotate the signing secret
  • Schemas
    • BankConnectionStatusEnum
    • AccountHoldingResource
    • AttachRuleToFinancialAccountRequest
    • BalanceCategoryEnum
    • CreateAppWebhookEndpointRequest
    • BankDataTypeEnum
    • AttachRuleToTransferLinkRequest
    • CreatePortalSessionRequest
    • BalanceTypeEnum
    • HealthResource
    • BulkDeleteFinancialAccountsRequest
    • BulkDeleteTransactionsRequest
    • IntegratorEnum
    • ManagedUserResource
    • RegisterManagedUserRequest
    • ManagedConnectionResource
    • BulkUndoRuleLogsRequest
    • UpdateManagedUserRequest
    • BulkUndoTransferLogsRequest
    • CreateGoogleSheetTabRequest
    • CreateFinancialConnectionRequest
    • CreateGoogleSheetsConnectionRequest
    • TestAppWebhookRequest
    • CreateLunchMoneyConnectionRequest
    • UpdateAppWebhookEndpointRequest
    • WebhookEndpointResource
    • CreateTransactionRequest
    • WebhookEventResource
    • WebhookEndpointPayloadVersion
    • CreateRuleRequest
    • CreateNotionConnectionRequest
    • WebhookEventTypeEnum
    • CreateWebhookEndpointRequest
    • CreateTransferLinkRequest
    • CreateYnabConnectionRequest
    • DestinationTypeEnum
    • EnrichmentProviderEnum
    • FinancialAccount
    • FinancialAccountBalanceResource
    • FinancialAccountResource
    • FinancialConnectionResource
    • GoogleSheetResource
    • GoogleSheetsConnectionResource
    • HealthStatusEnum
    • InstitutionConfigMappedDateEnum
    • InstitutionConfigMappedTextEnum
    • InstitutionConfigResource
    • InstitutionResource
    • LunchMoneyAccountResource
    • LunchMoneyConnectionResource
    • PreviewRuleRequest
    • NotionConnectionResource
    • ReauthorizeFinancialConnectionRequest
    • RetryTransfersAllLinksRequest
    • NotionDatabaseResource
    • RetryTransfersRequest
    • ReorderFinancialAccountRulesRequest
    • ReorderTransferLinkRulesRequest
    • RuleActionResource
    • RuleActionTypeEnum
    • RuleConditionResource
    • RuleLogResource
    • RuleOperatorEnum
    • RuleResource
    • SimpleFinAccountResource
    • RuleScopeEnum
    • SimpleFinAppEnum
    • RuleTypeEnum
    • SimpleFinConnectionResource
    • StoreGoogleSheetRequest
    • TransactionTypeEnum
    • StoreSimpleFinConnectionRequest
    • TestWebhookRequest
    • SyncFinancialAccountRequest
    • TransferLink
    • TransactionResource
    • TransferLinkSyncModeEnum
    • StoreNotionDatabaseRequest
    • TransferLogStatusEnum
    • TransferLinkResource
    • TransferLogResource
    • UpdateGoogleSheetRequest
    • UpdateGoogleSheetsConnectionRequest
    • UpdateLunchMoneyConnectionRequest
    • UpdateFinancialAccountRequest
    • UpdateRuleRequest
    • UpdateTransactionRequest
    • UpdateSimpleFinConnectionRequest
    • UpdateYnabBudgetRequest
    • UpdateWebhookEndpointRequest
    • UpdateYnabConnectionRequest
    • UpdateTransferLinkRequest
    • UpdateNotionConnectionRequest
    • UpdateNotionDatabaseRequest
    • UserProfileResource
    • WebhookTypeEnum
    • YnabBudgetAccountResource
    • YnabBudgetAccountTypeEnum
    • YnabBudgetResource
    • YnabConnectionResource
  1. Guides

MCP: Connect AI assistants

Synci ships a Model Context Protocol (MCP) server, so AI assistants like Claude can answer questions about your finances using live data from your connected accounts. Access is strictly read-only: the MCP server cannot create, modify, or delete anything in your Synci account.
MCP Endpoint
https://api.synci.io/mcp

Connecting a client#

Add the endpoint above to any MCP client that supports remote servers with OAuth (for example Claude, or other assistants that support MCP connectors). The client discovers Synci's OAuth configuration automatically and registers itself; no manual API keys are involved.
During authorization you will be asked to:
1.
Sign in to your Synci account.
2.
Approve the "Access your financial data through AI assistants (read-only)" permission.
3.
Select which accounts the assistant may see.
You can revoke the connection at any time from your Synci settings, and connect requires an active Synci subscription.

What the assistant can do#

ToolReturns
list_connectionsYour bank and provider connections and their health status
list_accountsYour connected financial accounts (bank, investment, crypto)
get_account_balanceRecent balance snapshots for one account
list_transactionsTransactions within a date range
list_holdingsInvestment and crypto positions (symbol, quantity, market value)
Data reflects the most recent sync from your bank or broker, not real-time values. Sensitive identifiers (IBANs, account numbers, card numbers, owner names) are always omitted from MCP responses.

Security model#

The MCP server follows the MCP authorization specification, which requires OAuth 2.1 with Dynamic Client Registration (RFC 7591). AI clients register themselves at https://api.synci.io/oauth/register when you connect them. That endpoint is intentionally open: it is how Claude, ChatGPT and other assistants obtain a client_id without a manual approval step, and it is not a vulnerability on its own. What a self-registered client can do is bounded by the controls below.
Scope confinement. Every self-registered client is pinned to the single mcp:use scope, regardless of what it requests at registration or authorization. That scope grants access to the read-only MCP tools listed above and nothing else. It cannot reach the REST API, the Developer Program surfaces, or any write operation.
PKCE is mandatory. Self-registered clients are public clients (no client secret). The authorization endpoint rejects any request from a public client that does not carry a code_challenge with the S256 method, so an intercepted authorization code cannot be exchanged for a token.
Redirect URIs are exact-match. The redirect_uri presented at authorization must exactly match one registered for that client. At registration, redirect URIs must use https; plain http is accepted only for localhost loopback callbacks, and browser-reserved schemes such as javascript: or data: are refused.
Consent is never skipped. Every self-registered client goes through the Synci consent screen. The screen names the client, shows the exact host that will receive the authorization code, and warns when the assistant is not one we recognise. Curated branding is only applied when the client's redirect host matches a known AI tool, so a client that merely names itself after a known assistant is shown as unrecognised. You also choose which accounts the assistant may see, and an active Synci subscription is required.
Rate limiting and monitoring. Registration is rate-limited per IP, and rejected registrations are reported to our error monitoring.
Revocation. You can disconnect any assistant from your Synci settings at any time. Access tokens expire after one hour and refresh tokens after 30 days.
If you believe you have found a security issue that bypasses one of these controls, contact us at support@synci.io. We do not run a paid bug bounty program.
Modified at 2026-09-28 19:08:10
Previous
Rate limits
Next
Synci as a SimpleFIN provider
Built with