@apteva/integrations 0.3.62 → 0.15.3

package/src/apps/adroll.json

@@ -0,0 +1,254 @@
+{
+  "slug": "adroll",
+  "name": "AdRoll",
+  "description": "AdRoll Ads API v2 — manage advertisables (ad accounts), campaigns, ad groups, ads, audiences, and pull retargeting/prospecting performance reports.",
+  "logo": "https://www.google.com/s2/favicons?domain=adroll.com&sz=128",
+  "categories": [
+    "advertising",
+    "marketing",
+    "campaigns",
+    "retargeting",
+    "prospecting",
+    "adroll",
+    "display-ads"
+  ],
+  "base_url": "https://services.adroll.com/api/v2",
+  "auth": {
+    "types": [
+      "bearer",
+      "oauth2"
+    ],
+    "headers": {
+      "Authorization": "Bearer {{token}}",
+      "X-Apikey": "{{api_key}}"
+    },
+    "credential_fields": [
+      {
+        "name": "token",
+        "label": "access_token",
+        "type": "password"
+      },
+      {
+        "name": "refresh_token",
+        "label": "refresh_token",
+        "type": "password"
+      },
+      {
+        "name": "api_key",
+        "label": "API Key (apikey)",
+        "type": "password",
+        "description": "X-Apikey header value — required by AdRoll on every Ads API call alongside the bearer token"
+      },
+      {
+        "name": "advertisable_eid",
+        "label": "Default Advertisable EID",
+        "description": "Default advertisable (ad-account) external id"
+      },
+      {
+        "name": "expires_in",
+        "label": "expires_in"
+      }
+    ],
+    "oauth2": {
+      "authorize_url": "https://services.adroll.com/auth/authorize",
+      "token_url": "https://services.adroll.com/auth/token",
+      "scopes": [],
+      "client_id_required": true,
+      "pkce": false
+    }
+  },
+  "tools": [
+    {
+      "name": "list_advertisables",
+      "description": "List advertisables (ad accounts) for the authenticated user.",
+      "method": "GET",
+      "path": "/advertisable",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "page_size": { "type": "integer", "default": 50 },
+          "page": { "type": "integer", "default": 1 }
+        }
+      }
+    },
+    {
+      "name": "get_advertisable",
+      "description": "Get a single advertisable by EID.",
+      "method": "GET",
+      "path": "/advertisable/{advertisable_eid}",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "advertisable_eid": { "type": "string" }
+        },
+        "required": ["advertisable_eid"]
+      }
+    },
+    {
+      "name": "list_campaigns",
+      "description": "List campaigns under an advertisable. Filter by status (live|paused|deleted) or type (web|prospecting|retargeting|email).",
+      "method": "GET",
+      "path": "/campaign",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "advertisable_eid": { "type": "string" },
+          "status": { "type": "string", "enum": ["live", "paused", "deleted"] },
+          "type": { "type": "string", "enum": ["web", "prospecting", "retargeting", "email", "social"] },
+          "page_size": { "type": "integer", "default": 50 },
+          "page": { "type": "integer", "default": 1 }
+        },
+        "required": ["advertisable_eid"]
+      }
+    },
+    {
+      "name": "create_campaign",
+      "description": "Create a campaign. Required: advertisable, name, type (web|prospecting|retargeting|email), budget (daily, in advertisable currency), bid_type (cpc|cpm), start_date (yyyy-MM-dd). Optional end_date, max_cpm, max_cpc, status (live|paused), source_audiences[], suppression_audiences[].",
+      "method": "POST",
+      "path": "/campaign",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "advertisable": { "type": "string", "description": "Advertisable EID" },
+          "name": { "type": "string" },
+          "type": { "type": "string", "enum": ["web", "prospecting", "retargeting", "email", "social"] },
+          "budget": { "type": "number", "description": "Daily budget" },
+          "bid_type": { "type": "string", "enum": ["cpc", "cpm"], "default": "cpm" },
+          "max_cpm": { "type": "number" },
+          "max_cpc": { "type": "number" },
+          "start_date": { "type": "string", "description": "yyyy-MM-dd" },
+          "end_date": { "type": "string" },
+          "status": { "type": "string", "enum": ["live", "paused"], "default": "paused" },
+          "source_audiences": { "type": "array", "items": { "type": "string" } },
+          "suppression_audiences": { "type": "array", "items": { "type": "string" } }
+        },
+        "required": ["advertisable", "name", "type", "budget", "start_date"]
+      }
+    },
+    {
+      "name": "update_campaign",
+      "description": "Update a campaign by EID. Pass only the fields you want to change.",
+      "method": "PUT",
+      "path": "/campaign/{campaign_eid}",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "campaign_eid": { "type": "string" },
+          "name": { "type": "string" },
+          "budget": { "type": "number" },
+          "max_cpm": { "type": "number" },
+          "max_cpc": { "type": "number" },
+          "end_date": { "type": "string" },
+          "status": { "type": "string", "enum": ["live", "paused", "deleted"] }
+        },
+        "required": ["campaign_eid"]
+      }
+    },
+    {
+      "name": "list_ad_groups",
+      "description": "List ad groups under an advertisable, optionally filtered by campaign.",
+      "method": "GET",
+      "path": "/adgroup",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "advertisable_eid": { "type": "string" },
+          "campaign": { "type": "string", "description": "Campaign EID" },
+          "page_size": { "type": "integer", "default": 50 },
+          "page": { "type": "integer", "default": 1 }
+        },
+        "required": ["advertisable_eid"]
+      }
+    },
+    {
+      "name": "list_ads",
+      "description": "List ads under an advertisable, optionally filtered by adgroup or campaign.",
+      "method": "GET",
+      "path": "/ad",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "advertisable_eid": { "type": "string" },
+          "campaign": { "type": "string" },
+          "adgroup": { "type": "string" },
+          "status": { "type": "string", "enum": ["pending", "approved", "rejected", "paused"] },
+          "page_size": { "type": "integer", "default": 50 },
+          "page": { "type": "integer", "default": 1 }
+        },
+        "required": ["advertisable_eid"]
+      }
+    },
+    {
+      "name": "create_ad",
+      "description": "Create an ad (creative) under an advertisable. Required: advertisable, type (image|html|video|native), headline (for native), body (for native/dynamic), click_url, image_url (for image), height, width, status.",
+      "method": "POST",
+      "path": "/ad",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "advertisable": { "type": "string" },
+          "type": { "type": "string", "enum": ["image", "html", "video", "native", "dynamic"] },
+          "headline": { "type": "string" },
+          "body": { "type": "string" },
+          "click_url": { "type": "string" },
+          "image_url": { "type": "string" },
+          "logo_url": { "type": "string" },
+          "height": { "type": "integer" },
+          "width": { "type": "integer" },
+          "status": { "type": "string", "enum": ["paused", "approved"], "default": "paused" }
+        },
+        "required": ["advertisable", "type", "click_url"]
+      }
+    },
+    {
+      "name": "list_audiences",
+      "description": "List audiences (segments) for an advertisable. type values: web (pixel-based), email (CRM), lookalike, behavioral.",
+      "method": "GET",
+      "path": "/audience",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "advertisable_eid": { "type": "string" },
+          "type": { "type": "string", "enum": ["web", "email", "lookalike", "behavioral"] },
+          "page_size": { "type": "integer", "default": 50 },
+          "page": { "type": "integer", "default": 1 }
+        },
+        "required": ["advertisable_eid"]
+      }
+    },
+    {
+      "name": "create_segment",
+      "description": "Create a website-visitor segment (audience). Required: advertisable, name, rules[] (array of rule objects describing URL match logic and lookback window).",
+      "method": "POST",
+      "path": "/segment",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "advertisable": { "type": "string" },
+          "name": { "type": "string" },
+          "rules": { "type": "array", "items": { "type": "object" } },
+          "duration": { "type": "integer", "description": "Membership duration in days" }
+        },
+        "required": ["advertisable", "name", "rules"]
+      }
+    },
+    {
+      "name": "report",
+      "description": "Pull a performance report. dimensions: advertisable|campaign|adgroup|ad|country|device|day|week|month. metrics: impressions, clicks, ctr, spend, cpm, cpc, view_through_conversions, click_through_conversions, total_conversions, revenue, roas. start_date / end_date as yyyy-MM-dd.",
+      "method": "POST",
+      "path": "/report",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "advertisable": { "type": "string" },
+          "dimensions": { "type": "array", "items": { "type": "string" } },
+          "metrics": { "type": "array", "items": { "type": "string" } },
+          "start_date": { "type": "string" },
+          "end_date": { "type": "string" },
+          "filters": { "type": "object", "description": "Optional {campaign: [eid], adgroup: [eid], ...}" }
+        },
+        "required": ["advertisable", "dimensions", "metrics", "start_date", "end_date"]
+      }
+    }
+  ]
+}

package/src/apps/ahrefs.json

@@ -0,0 +1,156 @@
+{
+  "slug": "ahrefs",
+  "name": "Ahrefs",
+  "description": "Ahrefs API v3 — Domain Rating, backlinks, referring domains, organic keywords, organic competitors, top pages, paid traffic. Industry-leading link database. Requires Enterprise / API plan.",
+  "logo": "https://www.google.com/s2/favicons?domain=ahrefs.com&sz=128",
+  "categories": ["seo", "backlinks", "keywords", "competitors", "link-analysis", "rank-tracking"],
+  "base_url": "https://api.ahrefs.com/v3",
+  "auth": {
+    "types": ["bearer"],
+    "headers": { "Authorization": "Bearer {{token}}" },
+    "credential_fields": [
+      { "name": "token", "label": "API Token", "description": "Generate at ahrefs.com/api/profile (Enterprise/API plan required)" }
+    ]
+  },
+  "tools": [
+    {
+      "name": "domain_rating",
+      "description": "Domain Rating (DR) for a target",
+      "method": "GET",
+      "path": "/site-explorer/domain-rating",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "target": { "type": "string" },
+          "date": { "type": "string" }
+        },
+        "required": ["target"]
+      }
+    },
+    {
+      "name": "backlinks",
+      "description": "List backlinks for a target with traffic and DR",
+      "method": "GET",
+      "path": "/site-explorer/all-backlinks",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "target": { "type": "string" },
+          "mode": { "type": "string", "description": "exact|prefix|domain|subdomains" },
+          "limit": { "type": "number" },
+          "offset": { "type": "number" },
+          "select": { "type": "string", "description": "Comma-separated fields, e.g. url_from,url_to,domain_rating_source,traffic_domain" },
+          "where": { "type": "string" },
+          "order_by": { "type": "string" }
+        },
+        "required": ["target", "select"]
+      }
+    },
+    {
+      "name": "referring_domains",
+      "description": "Referring domains pointing to a target",
+      "method": "GET",
+      "path": "/site-explorer/refdomains",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "target": { "type": "string" },
+          "mode": { "type": "string" },
+          "limit": { "type": "number" },
+          "select": { "type": "string" }
+        },
+        "required": ["target", "select"]
+      }
+    },
+    {
+      "name": "organic_keywords",
+      "description": "Organic keywords a target ranks for",
+      "method": "GET",
+      "path": "/site-explorer/organic-keywords",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "target": { "type": "string" },
+          "country": { "type": "string" },
+          "mode": { "type": "string" },
+          "limit": { "type": "number" },
+          "select": { "type": "string" }
+        },
+        "required": ["target", "country", "select"]
+      }
+    },
+    {
+      "name": "organic_competitors",
+      "description": "Organic competitors for a target",
+      "method": "GET",
+      "path": "/site-explorer/organic-competitors",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "target": { "type": "string" },
+          "country": { "type": "string" },
+          "mode": { "type": "string" },
+          "limit": { "type": "number" },
+          "select": { "type": "string" }
+        },
+        "required": ["target", "country", "select"]
+      }
+    },
+    {
+      "name": "top_pages",
+      "description": "Top pages on a domain by organic traffic",
+      "method": "GET",
+      "path": "/site-explorer/top-pages",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "target": { "type": "string" },
+          "country": { "type": "string" },
+          "mode": { "type": "string" },
+          "limit": { "type": "number" },
+          "select": { "type": "string" }
+        },
+        "required": ["target", "country", "select"]
+      }
+    },
+    {
+      "name": "keywords_explorer_overview",
+      "description": "Keywords Explorer overview — volume, KD, CPC, traffic potential",
+      "method": "GET",
+      "path": "/keywords-explorer/overview",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "keywords": { "type": "string", "description": "Comma-separated list" },
+          "country": { "type": "string" },
+          "select": { "type": "string" }
+        },
+        "required": ["keywords", "country", "select"]
+      }
+    },
+    {
+      "name": "metrics_history",
+      "description": "Historical metrics time series for a target",
+      "method": "GET",
+      "path": "/site-explorer/metrics-history",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "target": { "type": "string" },
+          "mode": { "type": "string" },
+          "history_grouping": { "type": "string", "description": "daily|weekly|monthly" },
+          "date_from": { "type": "string" },
+          "date_to": { "type": "string" }
+        },
+        "required": ["target"]
+      }
+    },
+    {
+      "name": "subscription_info",
+      "description": "Account subscription and quota usage",
+      "method": "GET",
+      "path": "/subscription-info/limits-and-usage",
+      "input_schema": { "type": "object", "properties": {} }
+    }
+  ]
+}

package/src/apps/airtable.json

@@ -23,19 +23,10 @@
     "credential_fields": [
       {
         "name": "token",
-        "label": "access_token"
-      },
-      {
-        "name": "refresh_token",
-        "label": "refresh_token"
-      },
-      {
-        "name": "expires_in",
-        "label": "expires_in"
-      },
-      {
-        "name": "token_type",
-        "label": "token_type"
+        "label": "Personal Access Token",
+        "description": "Your Airtable personal access token for bearer auth",
+        "required": true,
+        "type": "password"
       }
     ],
     "oauth2": {

package/src/apps/algolia.json

@@ -0,0 +1,115 @@
+{
+  "slug": "algolia",
+  "name": "Algolia",
+  "description": "MCP server for Algolia - search, indexing, and object management via the Algolia REST API",
+  "logo": "https://www.google.com/s2/favicons?domain=algolia.com&sz=128",
+  "categories": ["search", "database", "developer-tools"],
+  "base_url": "https://{{credential.app_id}}-dsn.algolia.net/1",
+  "auth": {
+    "types": ["api_key"],
+    "headers": {
+      "X-Algolia-Application-Id": "{{app_id}}",
+      "X-Algolia-API-Key": "{{api_key}}"
+    },
+    "credential_fields": [
+      { "name": "app_id", "label": "Application ID", "description": "Application ID from Settings → API Keys", "type": "text" },
+      { "name": "api_key", "label": "Admin API Key", "description": "Admin API Key (write access) or Search-Only API Key (read-only) from Settings → API Keys" }
+    ]
+  },
+  "tools": [
+    {
+      "name": "search_index",
+      "description": "Search records in an index",
+      "method": "POST",
+      "path": "/indexes/{indexName}/query",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "indexName": { "type": "string" },
+          "query": { "type": "string" },
+          "hitsPerPage": { "type": "integer" },
+          "page": { "type": "integer" },
+          "filters": { "type": "string", "description": "Filter expression, e.g. \"category:books AND price < 20\"" },
+          "facets": { "type": "array", "items": { "type": "string" } }
+        },
+        "required": ["indexName"]
+      }
+    },
+    {
+      "name": "list_indices",
+      "description": "List all indices in the application",
+      "method": "GET",
+      "path": "/indexes",
+      "input_schema": { "type": "object", "properties": {} }
+    },
+    {
+      "name": "save_object",
+      "description": "Add or update an object in an index. Including objectID upserts; omitting it creates a new record.",
+      "method": "POST",
+      "path": "/indexes/{indexName}",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "indexName": { "type": "string" },
+          "objectID": { "type": "string" }
+        },
+        "additionalProperties": true,
+        "required": ["indexName"]
+      }
+    },
+    {
+      "name": "get_object",
+      "description": "Retrieve an object by objectID",
+      "method": "GET",
+      "path": "/indexes/{indexName}/{objectID}",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "indexName": { "type": "string" },
+          "objectID": { "type": "string" }
+        },
+        "required": ["indexName", "objectID"]
+      }
+    },
+    {
+      "name": "delete_object",
+      "description": "Delete an object by objectID",
+      "method": "DELETE",
+      "path": "/indexes/{indexName}/{objectID}",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "indexName": { "type": "string" },
+          "objectID": { "type": "string" }
+        },
+        "required": ["indexName", "objectID"]
+      }
+    },
+    {
+      "name": "browse_index",
+      "description": "Browse all records in an index (paginated up to 1000 per call via cursor)",
+      "method": "POST",
+      "path": "/indexes/{indexName}/browse",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "indexName": { "type": "string" },
+          "cursor": { "type": "string" },
+          "filters": { "type": "string" }
+        },
+        "required": ["indexName"]
+      }
+    },
+    {
+      "name": "clear_index",
+      "description": "Delete all records in an index without removing the index itself",
+      "method": "POST",
+      "path": "/indexes/{indexName}/clear",
+      "input_schema": {
+        "type": "object",
+        "properties": { "indexName": { "type": "string" } },
+        "required": ["indexName"]
+      }
+    }
+  ]
+}