@apteva/integrations 0.3.62 → 0.15.3

package/src/apps/pinterest.json

@@ -0,0 +1,217 @@
+{
+  "slug": "pinterest",
+  "name": "Pinterest",
+  "description": "MCP server for Pinterest - boards, pins, user account, analytics",
+  "logo": "https://www.google.com/s2/favicons?domain=pinterest.com&sz=128",
+  "categories": ["social", "content", "marketing", "visual"],
+  "base_url": "https://api.pinterest.com/v5",
+  "auth": {
+    "types": ["oauth2", "bearer"],
+    "headers": { "Authorization": "Bearer {{token}}" },
+    "credential_fields": [
+      { "name": "token", "label": "OAuth Access Token" },
+      { "name": "appId", "label": "App ID" },
+      { "name": "appSecret", "label": "App Secret" }
+    ]
+  },
+  "tools": [
+    {
+      "name": "list_boards",
+      "description": "List boards owned by the authenticated user",
+      "method": "GET",
+      "path": "/boards",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "bookmark": { "type": "string" },
+          "page_size": { "type": "number" },
+          "privacy": { "type": "string" }
+        }
+      },
+      "mock_response": {
+        "items": [
+          {
+            "id": "800000000000000001",
+            "name": "Inspiration",
+            "description": "Design ideas",
+            "privacy": "PUBLIC",
+            "pin_count": 42,
+            "follower_count": 18,
+            "created_at": "2025-04-01T00:00:00"
+          }
+        ],
+        "bookmark": null
+      }
+    },
+    {
+      "name": "create_board",
+      "description": "Create a board",
+      "method": "POST",
+      "path": "/boards",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "name": { "type": "string" },
+          "description": { "type": "string" },
+          "privacy": { "type": "string", "enum": ["PUBLIC", "SECRET"] }
+        },
+        "required": ["name"]
+      },
+      "mock_response": {
+        "id": "800000000000000099",
+        "name": "(board name)",
+        "description": "",
+        "privacy": "PUBLIC",
+        "pin_count": 0,
+        "follower_count": 0,
+        "created_at": "2026-05-22T12:00:00"
+      }
+    },
+    {
+      "name": "get_board",
+      "description": "Get a board",
+      "method": "GET",
+      "path": "/boards/{board_id}",
+      "input_schema": {
+        "type": "object",
+        "properties": { "board_id": { "type": "string" } },
+        "required": ["board_id"]
+      },
+      "mock_response": {
+        "id": "800000000000000001",
+        "name": "Inspiration",
+        "description": "Design ideas",
+        "privacy": "PUBLIC",
+        "pin_count": 42,
+        "follower_count": 18,
+        "created_at": "2025-04-01T00:00:00"
+      }
+    },
+    {
+      "name": "list_pins",
+      "description": "List pins",
+      "method": "GET",
+      "path": "/pins",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "bookmark": { "type": "string" },
+          "page_size": { "type": "number" }
+        }
+      },
+      "mock_response": {
+        "items": [
+          {
+            "id": "900000000000000001",
+            "created_at": "2026-05-22T10:00:00",
+            "link": "https://example.com/article",
+            "title": "A great idea",
+            "description": "",
+            "board_id": "800000000000000001",
+            "media": {
+              "media_type": "image"
+            }
+          }
+        ],
+        "bookmark": null
+      }
+    },
+    {
+      "name": "create_pin",
+      "description": "Create a pin",
+      "method": "POST",
+      "path": "/pins",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "board_id": { "type": "string" },
+          "title": { "type": "string" },
+          "description": { "type": "string" },
+          "link": { "type": "string" },
+          "media_source": { "type": "object" },
+          "alt_text": { "type": "string" }
+        },
+        "required": ["board_id", "media_source"]
+      },
+      "mock_response": {
+        "id": "900000000000000099",
+        "created_at": "2026-05-22T12:00:00",
+        "link": "https://example.com/article",
+        "title": "(pin title)",
+        "description": "",
+        "board_id": "800000000000000001",
+        "board_owner": {
+          "username": "apteva"
+        },
+        "media": {
+          "media_type": "image"
+        }
+      }
+    },
+    {
+      "name": "delete_pin",
+      "description": "Delete a pin",
+      "method": "DELETE",
+      "path": "/pins/{pin_id}",
+      "input_schema": {
+        "type": "object",
+        "properties": { "pin_id": { "type": "string" } },
+        "required": ["pin_id"]
+      },
+      "mock_response": {
+        "success": true
+      }
+    },
+    {
+      "name": "get_user_account",
+      "description": "Get the authenticated user's account info",
+      "method": "GET",
+      "path": "/user_account",
+      "input_schema": { "type": "object", "properties": {} },
+      "mock_response": {
+        "username": "apteva",
+        "account_type": "BUSINESS",
+        "profile_image": "https://i.pinimg.com/mock-profile.jpg",
+        "website_url": "https://apteva.example",
+        "board_count": 8,
+        "pin_count": 124,
+        "follower_count": 340,
+        "following_count": 56
+      }
+    },
+    {
+      "name": "get_user_analytics",
+      "description": "Get user account analytics",
+      "method": "GET",
+      "path": "/user_account/analytics",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "start_date": { "type": "string" },
+          "end_date": { "type": "string" },
+          "metric_types": { "type": "array" }
+        },
+        "required": ["start_date", "end_date"]
+      },
+      "mock_response": {
+        "all": {
+          "daily_metrics": [
+            {
+              "date": "2026-05-22",
+              "metrics": {
+                "IMPRESSION": 1820,
+                "PIN_CLICK": 94,
+                "SAVE": 31
+              }
+            }
+          ],
+          "summary_metrics": {
+            "IMPRESSION": 1820,
+            "PIN_CLICK": 94,
+            "SAVE": 31
+          }
+        }
+      }
+    }
+  ]
+}

package/src/apps/planetscale.json

@@ -0,0 +1,139 @@
+{
+  "slug": "planetscale",
+  "name": "PlanetScale",
+  "description": "MCP server for PlanetScale - databases, branches, deploy requests, backups",
+  "logo": "https://www.google.com/s2/favicons?domain=planetscale.com&sz=128",
+  "categories": ["database", "mysql", "serverless", "devops"],
+  "base_url": "https://api.planetscale.com/v1",
+  "auth": {
+    "types": ["header"],
+    "headers": { "Authorization": "{{serviceTokenId}}:{{serviceToken}}" },
+    "credential_fields": [
+      { "name": "serviceTokenId", "label": "Service Token ID" },
+      { "name": "serviceToken", "label": "Service Token" },
+      { "name": "organization", "label": "Organization" }
+    ]
+  },
+  "tools": [
+    {
+      "name": "list_databases",
+      "description": "List databases in an organization",
+      "method": "GET",
+      "path": "/organizations/{organization}/databases",
+      "input_schema": {
+        "type": "object",
+        "properties": { "organization": { "type": "string" } },
+        "required": ["organization"]
+      }
+    },
+    {
+      "name": "create_database",
+      "description": "Create a database",
+      "method": "POST",
+      "path": "/organizations/{organization}/databases",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "organization": { "type": "string" },
+          "name": { "type": "string" },
+          "region": { "type": "string" },
+          "plan": { "type": "string" }
+        },
+        "required": ["organization", "name"]
+      }
+    },
+    {
+      "name": "list_branches",
+      "description": "List branches for a database",
+      "method": "GET",
+      "path": "/organizations/{organization}/databases/{database}/branches",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "organization": { "type": "string" },
+          "database": { "type": "string" }
+        },
+        "required": ["organization", "database"]
+      }
+    },
+    {
+      "name": "create_branch",
+      "description": "Create a branch",
+      "method": "POST",
+      "path": "/organizations/{organization}/databases/{database}/branches",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "organization": { "type": "string" },
+          "database": { "type": "string" },
+          "name": { "type": "string" },
+          "parent_branch": { "type": "string" }
+        },
+        "required": ["organization", "database", "name", "parent_branch"]
+      }
+    },
+    {
+      "name": "list_deploy_requests",
+      "description": "List deploy requests",
+      "method": "GET",
+      "path": "/organizations/{organization}/databases/{database}/deploy-requests",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "organization": { "type": "string" },
+          "database": { "type": "string" }
+        },
+        "required": ["organization", "database"]
+      }
+    },
+    {
+      "name": "create_deploy_request",
+      "description": "Open a deploy request",
+      "method": "POST",
+      "path": "/organizations/{organization}/databases/{database}/deploy-requests",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "organization": { "type": "string" },
+          "database": { "type": "string" },
+          "branch": { "type": "string" },
+          "into_branch": { "type": "string" },
+          "notes": { "type": "string" }
+        },
+        "required": ["organization", "database", "branch", "into_branch"]
+      }
+    },
+    {
+      "name": "deploy_deploy_request",
+      "description": "Deploy a deploy request",
+      "method": "POST",
+      "path": "/organizations/{organization}/databases/{database}/deploy-requests/{number}/deploy",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "organization": { "type": "string" },
+          "database": { "type": "string" },
+          "number": { "type": "string" }
+        },
+        "required": ["organization", "database", "number"]
+      }
+    },
+    {
+      "name": "create_password",
+      "description": "Create a branch connection password",
+      "method": "POST",
+      "path": "/organizations/{organization}/databases/{database}/branches/{branch}/passwords",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "organization": { "type": "string" },
+          "database": { "type": "string" },
+          "branch": { "type": "string" },
+          "name": { "type": "string" },
+          "role": { "type": "string" }
+        },
+        "required": ["organization", "database", "branch", "name"]
+      }
+    }
+  ]
+}

package/src/apps/polygonscan.json

@@ -0,0 +1,157 @@
+{
+  "slug": "polygonscan",
+  "name": "Polygonscan",
+  "description": "Polygon (MATIC) mainnet block explorer API — same tool surface as Etherscan, different chain. ESPECIALLY relevant to Polymarket: their CLOB settles every order on Polygon, so on-chain views of YOUR wallet's USDC balance + ERC-1155 conditional token holdings + USDC transfers to/from Polymarket contracts are all served from here. Whale watching on Polymarket markets means tracking specific Polygon addresses. Free tier: 5 req/sec. Sign up at https://polygonscan.com/apis.",
+  "logo": "https://www.google.com/s2/favicons?domain=polygonscan.com&sz=128",
+  "categories": [
+    "crypto",
+    "polygon",
+    "explorer",
+    "on-chain",
+    "polymarket",
+    "matic",
+    "blockchain"
+  ],
+  "base_url": "https://api.polygonscan.com",
+  "auth": {
+    "types": ["api_key"],
+    "query_params": {
+      "apikey": "{{api_key}}"
+    },
+    "credential_fields": [
+      {
+        "name": "api_key",
+        "label": "API Key",
+        "description": "From your Polygonscan account dashboard at https://polygonscan.com/myapikey. Same Etherscan-family auth model; key is distinct from your Etherscan key."
+      }
+    ]
+  },
+  "tools": [
+    {
+      "name": "matic_balance",
+      "description": "Native MATIC balance for an address, in wei. Divide by 1e18 for MATIC. Polymarket users need MATIC for gas; this is how you check they have enough to cancel/place orders.",
+      "method": "GET",
+      "path": "/api?module=account&action=balance&tag=latest",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "address": {"type": "string"}
+        },
+        "required": ["address"]
+      }
+    },
+    {
+      "name": "tx_list",
+      "description": "Normal transactions for an address on Polygon.",
+      "method": "GET",
+      "path": "/api?module=account&action=txlist",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "address":    {"type": "string"},
+          "startblock": {"type": "integer", "default": 0},
+          "endblock":   {"type": "integer", "default": 99999999},
+          "page":       {"type": "integer", "default": 1},
+          "offset":     {"type": "integer", "default": 100},
+          "sort":       {"type": "string", "enum": ["asc","desc"], "default": "desc"}
+        },
+        "required": ["address"]
+      }
+    },
+    {
+      "name": "internal_tx_list",
+      "description": "Internal contract-to-contract transactions for an address. Polymarket trades route through their CTF Exchange contract — internal txs are what reveal the actual fund movements.",
+      "method": "GET",
+      "path": "/api?module=account&action=txlistinternal",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "address":    {"type": "string"},
+          "startblock": {"type": "integer", "default": 0},
+          "endblock":   {"type": "integer", "default": 99999999},
+          "page":       {"type": "integer", "default": 1},
+          "offset":     {"type": "integer", "default": 100},
+          "sort":       {"type": "string", "enum": ["asc","desc"], "default": "desc"}
+        },
+        "required": ["address"]
+      }
+    },
+    {
+      "name": "erc20_transfers",
+      "description": "ERC-20 token transfers for an address. Polygon's USDC contract is 0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174 — filter by that to see ALL USDC movements (deposits/withdrawals/Polymarket settlement). Whale-following polymarket players means watching big addresses for USDC out → Polymarket and YES/NO tokens back.",
+      "method": "GET",
+      "path": "/api?module=account&action=tokentx",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "address":         {"type": "string"},
+          "contractaddress": {"type": "string", "description": "0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174 = USDC on Polygon."},
+          "startblock":      {"type": "integer", "default": 0},
+          "endblock":        {"type": "integer", "default": 99999999},
+          "page":            {"type": "integer", "default": 1},
+          "offset":          {"type": "integer", "default": 100},
+          "sort":            {"type": "string", "enum": ["asc","desc"], "default": "desc"}
+        },
+        "required": ["address"]
+      }
+    },
+    {
+      "name": "erc20_balance",
+      "description": "ERC-20 balance for an address against one specific token contract on Polygon.",
+      "method": "GET",
+      "path": "/api?module=account&action=tokenbalance&tag=latest",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "address":         {"type": "string"},
+          "contractaddress": {"type": "string"}
+        },
+        "required": ["address","contractaddress"]
+      }
+    },
+    {
+      "name": "tx_status",
+      "description": "Polygon transaction success/failure status. Useful when a Polymarket order's broker_order_id was registered but you're not sure if the settlement landed.",
+      "method": "GET",
+      "path": "/api?module=transaction&action=getstatus",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "txhash": {"type": "string"}
+        },
+        "required": ["txhash"]
+      }
+    },
+    {
+      "name": "block_by_time",
+      "description": "Find the closest Polygon block number for a given Unix timestamp.",
+      "method": "GET",
+      "path": "/api?module=block&action=getblocknobytime",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "timestamp": {"type": "integer"},
+          "closest":   {"type": "string", "enum": ["before","after"], "default": "before"}
+        },
+        "required": ["timestamp"]
+      }
+    },
+    {
+      "name": "gas_oracle",
+      "description": "Polygon gas prices in gwei. MATIC gas is much cheaper than ETH but still varies — check before tx-heavy bursts.",
+      "method": "GET",
+      "path": "/api?module=gastracker&action=gasoracle",
+      "input_schema": {"type": "object", "properties": {}}
+    },
+    {
+      "name": "matic_price",
+      "description": "Current MATIC/BTC and MATIC/USD prices via Polygonscan's feed.",
+      "method": "GET",
+      "path": "/api?module=stats&action=maticprice",
+      "input_schema": {"type": "object", "properties": {}}
+    }
+  ],
+  "health_check": {
+    "tool": "gas_oracle"
+  }
+}