Agent Skill · Pluggy

pluggy-integration

Core Pluggy integration patterns and best practices. Use when setting up Pluggy SDK, implementing Connect Widget, managing Items, or configuring webhooks.

Provider: Pluggy Path in repo: pluggy-integration/SKILL.md

Skill body

Pluggy Integration

Comprehensive integration guide for Pluggy Open Finance API. Contains rules across 5 categories, prioritized by impact to guide accurate implementation.

When to Apply

Reference these guidelines when:

Rule Categories by Priority

Priority Category Impact Prefix
1 Authentication CRITICAL auth-
2 Connect Widget CRITICAL widget-
3 Webhook Configuration CRITICAL webhook-
4 Item Lifecycle HIGH item-
5 Error Handling MEDIUM error-

How to Use

Read individual rule files for detailed explanations and code examples:

rules/auth-api-keys.md
rules/widget-integration.md
rules/item-lifecycle.md

Each rule file contains:

Key Concepts

Connection Sync vs Data Sync

Responsibility Who Handles How
Connection sync Pluggy Auto-sync every 24/12/8h
Triggering updates User Only when user explicitly requests
Entity data sync You Fetch all on item/updated webhook
Transaction sync You Use transactions/* webhook events

API Key vs Connect Token

Item Lifecycle

  1. User opens Connect Widget with Connect Token
  2. User selects connector and authenticates
  3. Pluggy creates Item and starts data sync
  4. Webhook notifies when sync completes
  5. Backend retrieves data using API Key
  6. Pluggy auto-syncs daily; webhook triggers data refresh

Full Compiled Document

For the complete guide with all rules expanded: AGENTS.md

Skill frontmatter

license: MIT metadata: {"author" => "pluggy", "version" => "1.0.0"}

Work with this as data

Every skill here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for agent skills

4 MCP tools reach this
  • find_skillsBrowse and filter every skill in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This skill
curl "https://apis.io/api/v1/skills/pluggy-integration"
All agent skills
curl "https://apis.io/api/v1/skills?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.