@apteva/integrations 0.3.62 → 0.15.4

package/src/apps/etherscan.json

@@ -0,0 +1,162 @@
+{
+  "slug": "etherscan",
+  "name": "Etherscan",
+  "description": "Ethereum mainnet block explorer API — on-chain queries about addresses, transactions, ERC-20 transfers, internal calls, gas, and supply. The de-facto canonical source for Ethereum chain reads. Use for whale-wallet watching (track addresses with >$10M positions), tx-history audits, ERC-20 movement detection, and gas-price awareness for time-sensitive trades. Free tier: 5 req/sec (no daily cap). Sign up at https://etherscan.io/apis. Note: all calls go through a single /api endpoint with module + action as query params — that's Etherscan's design, not ours.",
+  "logo": "https://www.google.com/s2/favicons?domain=etherscan.io&sz=128",
+  "categories": [
+    "crypto",
+    "ethereum",
+    "explorer",
+    "on-chain",
+    "defi",
+    "blockchain"
+  ],
+  "base_url": "https://api.etherscan.io",
+  "auth": {
+    "types": ["api_key"],
+    "query_params": {
+      "apikey": "{{api_key}}"
+    },
+    "credential_fields": [
+      {
+        "name": "api_key",
+        "label": "API Key",
+        "description": "From your Etherscan account dashboard at https://etherscan.io/myapikey. Free tier: 5 req/sec, no daily cap."
+      }
+    ]
+  },
+  "tools": [
+    {
+      "name": "eth_balance",
+      "description": "Native ETH balance for an address, in wei. Divide by 1e18 for ether. Use for tracking whale-wallet net worth movements.",
+      "method": "GET",
+      "path": "/api?module=account&action=balance&tag=latest",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "address": {"type": "string", "description": "0x-prefixed 40-char hex address."}
+        },
+        "required": ["address"]
+      }
+    },
+    {
+      "name": "tx_list",
+      "description": "List normal transactions (calls + value transfers) for an address. Returns up to 10k rows per page; paginate via page + offset. Use for full tx-history audits.",
+      "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, "description": "Rows per page, max 10000."},
+          "sort":       {"type": "string", "enum": ["asc","desc"], "default": "desc"}
+        },
+        "required": ["address"]
+      }
+    },
+    {
+      "name": "internal_tx_list",
+      "description": "Internal transactions (contract-to-contract calls that moved value, not externally-initiated). Critical for tracing where funds actually moved — visible normal txs only show the top-level call.",
+      "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 involving an address. Filter by contractaddress for one specific token (e.g. USDC = 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48). Without contractaddress, returns every token interaction. Critical for following whale flows in/out of major stablecoins or memecoins.",
+      "method": "GET",
+      "path": "/api?module=account&action=tokentx",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "address":         {"type": "string"},
+          "contractaddress": {"type": "string", "description": "Optional — restrict to one token contract."},
+          "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. Result is in the token's base units; divide by 10^decimals to get human-readable.",
+      "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": "Was a transaction successful? Returns {isError, errDescription}. Use to verify large pending tx outcomes for time-sensitive trading decisions.",
+      "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 block number for a given Unix timestamp. Useful for 'what was X's balance at exactly 14:00 UTC yesterday' analysis.",
+      "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": "Current gas prices — SafeGasPrice, ProposeGasPrice, FastGasPrice (in gwei). Use before sending tx to estimate timing + cost.",
+      "method": "GET",
+      "path": "/api?module=gastracker&action=gasoracle",
+      "input_schema": {
+        "type": "object",
+        "properties": {}
+      }
+    },
+    {
+      "name": "eth_price",
+      "description": "Current ETH/BTC and ETH/USD prices according to Etherscan's data feed.",
+      "method": "GET",
+      "path": "/api?module=stats&action=ethprice",
+      "input_schema": {
+        "type": "object",
+        "properties": {}
+      }
+    }
+  ],
+  "health_check": {
+    "tool": "gas_oracle"
+  }
+}

package/src/apps/etsy.json

@@ -0,0 +1,484 @@
+{
+  "slug": "etsy",
+  "name": "Etsy",
+  "description": "Etsy Open API v3 \u2014 manage shops, listings, orders (receipts), and reviews on Etsy. OAuth2 with PKCE; the keystring (client_id) doubles as the x-api-key header.",
+  "logo": "https://www.google.com/s2/favicons?domain=etsy.com&sz=128",
+  "categories": [
+    "ecommerce",
+    "marketplace",
+    "etsy",
+    "store",
+    "listings",
+    "orders",
+    "handmade",
+    "retail"
+  ],
+  "base_url": "https://openapi.etsy.com/v3/application",
+  "auth": {
+    "types": [
+      "oauth2"
+    ],
+    "headers": {
+      "Authorization": "Bearer {{token}}",
+      "x-api-key": "{{client_id}}"
+    },
+    "credential_fields": [
+      {
+        "name": "token",
+        "label": "access_token"
+      },
+      {
+        "name": "refresh_token",
+        "label": "refresh_token"
+      },
+      {
+        "name": "client_id",
+        "label": "Keystring (Client ID)",
+        "description": "Etsy app keystring from etsy.com/developers \u2014 also sent as the x-api-key header on every request."
+      }
+    ],
+    "oauth2": {
+      "authorize_url": "https://www.etsy.com/oauth/connect",
+      "token_url": "https://api.etsy.com/v3/public/oauth/token",
+      "scopes": [
+        "shops_r",
+        "shops_w",
+        "listings_r",
+        "listings_w",
+        "transactions_r",
+        "transactions_w",
+        "profile_r",
+        "email_r"
+      ],
+      "client_id_required": true,
+      "pkce": true
+    }
+  },
+  "tools": [
+    {
+      "name": "get_authenticated_user",
+      "description": "Get the user_id of the currently authenticated Etsy user.",
+      "method": "GET",
+      "path": "/users/me",
+      "input_schema": {
+        "type": "object",
+        "properties": {}
+      }
+    },
+    {
+      "name": "get_user",
+      "description": "Get an Etsy user's public profile by user ID.",
+      "method": "GET",
+      "path": "/users/{user_id}",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "user_id": {
+            "type": "integer"
+          }
+        },
+        "required": [
+          "user_id"
+        ]
+      }
+    },
+    {
+      "name": "get_shop_by_owner",
+      "description": "Get the shop belonging to the authenticated user.",
+      "method": "GET",
+      "path": "/users/{user_id}/shops",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "user_id": {
+            "type": "integer",
+            "description": "Etsy user ID (from get_authenticated_user)."
+          }
+        },
+        "required": [
+          "user_id"
+        ]
+      }
+    },
+    {
+      "name": "get_shop",
+      "description": "Get a shop by ID \u2014 name, currency, listing counts, vacation status.",
+      "method": "GET",
+      "path": "/shops/{shop_id}",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "shop_id": {
+            "type": "integer"
+          }
+        },
+        "required": [
+          "shop_id"
+        ]
+      }
+    },
+    {
+      "name": "list_shop_listings_active",
+      "description": "List active listings in a shop. Supports pagination + sort by created/updated/price/score.",
+      "method": "GET",
+      "path": "/shops/{shop_id}/listings/active",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "shop_id": {
+            "type": "integer"
+          },
+          "limit": {
+            "type": "integer",
+            "description": "Max 100."
+          },
+          "offset": {
+            "type": "integer"
+          },
+          "keywords": {
+            "type": "string"
+          },
+          "sort_on": {
+            "type": "string",
+            "enum": [
+              "created",
+              "price",
+              "updated",
+              "score"
+            ]
+          },
+          "sort_order": {
+            "type": "string",
+            "enum": [
+              "asc",
+              "desc",
+              "ascending",
+              "descending"
+            ]
+          }
+        },
+        "required": [
+          "shop_id"
+        ]
+      }
+    },
+    {
+      "name": "get_listing",
+      "description": "Get a single listing by ID. Use 'includes' to embed Images, Videos, Inventory, Translations, etc.",
+      "method": "GET",
+      "path": "/listings/{listing_id}",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "listing_id": {
+            "type": "integer"
+          },
+          "includes": {
+            "type": "string",
+            "description": "Comma-separated associations (e.g. 'Images,Videos,Inventory,Shipping')."
+          }
+        },
+        "required": [
+          "listing_id"
+        ]
+      }
+    },
+    {
+      "name": "create_draft_listing",
+      "description": "Create a new draft listing in the seller's shop. The listing starts inactive \u2014 call update_listing to set state='active' once images and inventory are attached.",
+      "method": "POST",
+      "path": "/shops/{shop_id}/listings",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "shop_id": {
+            "type": "integer"
+          },
+          "quantity": {
+            "type": "integer",
+            "description": "Number of items available."
+          },
+          "title": {
+            "type": "string",
+            "description": "Max 140 chars."
+          },
+          "description": {
+            "type": "string"
+          },
+          "price": {
+            "type": "number",
+            "description": "Listing price in shop's currency."
+          },
+          "who_made": {
+            "type": "string",
+            "enum": [
+              "i_did",
+              "someone_else",
+              "collective"
+            ]
+          },
+          "when_made": {
+            "type": "string",
+            "description": "Period code (e.g. 'made_to_order', '2020_2025', 'before_2006')."
+          },
+          "taxonomy_id": {
+            "type": "integer",
+            "description": "Etsy taxonomy node ID."
+          },
+          "shipping_profile_id": {
+            "type": "integer"
+          },
+          "return_policy_id": {
+            "type": "integer"
+          },
+          "tags": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "description": "Up to 13 tags, max 20 chars each."
+          },
+          "materials": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
+          "type": {
+            "type": "string",
+            "enum": [
+              "physical",
+              "download",
+              "both"
+            ]
+          },
+          "is_supply": {
+            "type": "boolean"
+          }
+        },
+        "required": [
+          "shop_id",
+          "quantity",
+          "title",
+          "description",
+          "price",
+          "who_made",
+          "when_made",
+          "taxonomy_id"
+        ]
+      }
+    },
+    {
+      "name": "update_listing",
+      "description": "Update fields on an existing listing. Use state='active' to publish a draft. Pass only the fields you want to change.",
+      "method": "PATCH",
+      "path": "/shops/{shop_id}/listings/{listing_id}",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "shop_id": {
+            "type": "integer"
+          },
+          "listing_id": {
+            "type": "integer"
+          },
+          "title": {
+            "type": "string"
+          },
+          "description": {
+            "type": "string"
+          },
+          "price": {
+            "type": "number"
+          },
+          "quantity": {
+            "type": "integer"
+          },
+          "tags": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
+          "materials": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
+          "state": {
+            "type": "string",
+            "enum": [
+              "active",
+              "inactive",
+              "draft"
+            ]
+          },
+          "shipping_profile_id": {
+            "type": "integer"
+          },
+          "return_policy_id": {
+            "type": "integer"
+          }
+        },
+        "required": [
+          "shop_id",
+          "listing_id"
+        ]
+      }
+    },
+    {
+      "name": "delete_listing",
+      "description": "Delete a listing. Etsy disallows deletion of sold-out listings \u2014 deactivate them via update_listing instead.",
+      "method": "DELETE",
+      "path": "/listings/{listing_id}",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "listing_id": {
+            "type": "integer"
+          }
+        },
+        "required": [
+          "listing_id"
+        ]
+      }
+    },
+    {
+      "name": "list_shop_receipts",
+      "description": "List orders (receipts) for a shop \u2014 buyer info, items, totals, shipment status. Filter by paid/shipped status and date range.",
+      "method": "GET",
+      "path": "/shops/{shop_id}/receipts",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "shop_id": {
+            "type": "integer"
+          },
+          "min_created": {
+            "type": "integer",
+            "description": "Unix timestamp lower bound."
+          },
+          "max_created": {
+            "type": "integer"
+          },
+          "min_last_modified": {
+            "type": "integer"
+          },
+          "max_last_modified": {
+            "type": "integer"
+          },
+          "limit": {
+            "type": "integer"
+          },
+          "offset": {
+            "type": "integer"
+          },
+          "was_paid": {
+            "type": "boolean"
+          },
+          "was_shipped": {
+            "type": "boolean"
+          },
+          "was_delivered": {
+            "type": "boolean"
+          },
+          "was_canceled": {
+            "type": "boolean"
+          }
+        },
+        "required": [
+          "shop_id"
+        ]
+      }
+    },
+    {
+      "name": "get_shop_receipt",
+      "description": "Get a single receipt (order) by ID.",
+      "method": "GET",
+      "path": "/shops/{shop_id}/receipts/{receipt_id}",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "shop_id": {
+            "type": "integer"
+          },
+          "receipt_id": {
+            "type": "integer"
+          }
+        },
+        "required": [
+          "shop_id",
+          "receipt_id"
+        ]
+      }
+    },
+    {
+      "name": "create_receipt_shipment",
+      "description": "Mark a receipt as shipped and optionally attach a tracking number / carrier to notify the buyer.",
+      "method": "POST",
+      "path": "/shops/{shop_id}/receipts/{receipt_id}/tracking",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "shop_id": {
+            "type": "integer"
+          },
+          "receipt_id": {
+            "type": "integer"
+          },
+          "tracking_code": {
+            "type": "string"
+          },
+          "carrier_name": {
+            "type": "string",
+            "description": "e.g. 'usps', 'fedex', 'ups', 'dhl'."
+          },
+          "send_bcc": {
+            "type": "boolean",
+            "description": "BCC the seller on the buyer notification email."
+          },
+          "note_to_buyer": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "shop_id",
+          "receipt_id"
+        ]
+      }
+    },
+    {
+      "name": "list_shop_reviews",
+      "description": "List reviews left on a shop's listings.",
+      "method": "GET",
+      "path": "/shops/{shop_id}/reviews",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "shop_id": {
+            "type": "integer"
+          },
+          "limit": {
+            "type": "integer"
+          },
+          "offset": {
+            "type": "integer"
+          },
+          "min_created": {
+            "type": "integer"
+          },
+          "max_created": {
+            "type": "integer"
+          }
+        },
+        "required": [
+          "shop_id"
+        ]
+      }
+    }
+  ],
+  "health_check": {
+    "tool": "get_authenticated_user"
+  }
+}

package/src/apps/eventbrite-events.json

@@ -620,5 +620,8 @@
         "properties": {}
       }
     }
-  ]
-}
+  ],
+  "health_check": {
+    "tool": "get_user"
+  }
+}