@apteva/integrations 0.3.62 → 0.15.3

package/src/apps/wikipedia.json

@@ -0,0 +1,112 @@
+{
+  "slug": "wikipedia",
+  "name": "Wikipedia",
+  "description": "Free encyclopedia API — page lookups, search, and the recent-changes firehose. Wikipedia updates remarkably fast on major real-world events (deaths, election outcomes, breaking news) — often within minutes — making it a surprisingly good 'has X happened?' sentinel for prediction markets. The recent-changes feed is the canonical way to monitor for sudden edits to a specific article. No auth required, just a polite User-Agent.",
+  "logo": "https://www.google.com/s2/favicons?domain=wikipedia.org&sz=128",
+  "categories": [
+    "knowledge",
+    "research",
+    "news",
+    "public-data",
+    "encyclopedia"
+  ],
+  "base_url": "https://en.wikipedia.org",
+  "auth": {
+    "types": ["none"],
+    "headers": {
+      "User-Agent": "Apteva-Trading-Agent/1.0 (https://apteva.com)",
+      "Accept": "application/json"
+    },
+    "credential_fields": []
+  },
+  "tools": [
+    {
+      "name": "page_summary",
+      "description": "Lead-paragraph summary of a Wikipedia article. Returns title, description, extract (first paragraph plain text), thumbnail, and last-modified timestamp. Use as a cheap LLM-friendly snapshot of any noun phrase ('Federal Reserve', 'Donald Trump', 'Bitcoin'). Disambiguation pages return a list of candidates.",
+      "method": "GET",
+      "path": "/api/rest_v1/page/summary/{title}",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "title": {"type": "string", "description": "Article title — URL-safe form. Spaces become underscores."}
+        },
+        "required": ["title"]
+      }
+    },
+    {
+      "name": "search",
+      "description": "Search Wikipedia articles by free-text query. Returns suggestions with title + snippet. Use to resolve a topic to a stable article title before page_summary.",
+      "method": "GET",
+      "path": "/w/api.php",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "action":   {"type": "string", "default": "query"},
+          "list":     {"type": "string", "default": "search"},
+          "srsearch": {"type": "string", "description": "Search query."},
+          "format":   {"type": "string", "default": "json"},
+          "srlimit":  {"type": "integer", "description": "Max results, default 10."},
+          "srprop":   {"type": "string", "default": "snippet|titlesnippet|timestamp"}
+        },
+        "required": ["srsearch"]
+      }
+    },
+    {
+      "name": "recent_changes",
+      "description": "Recent edits across Wikipedia, optionally filtered by namespace, type, or specific title. Use to monitor an article for sudden edits — Wikipedia editors often update key articles within minutes of major events (deaths, election outcomes, company news). A 'last edited 2 minutes ago' on a Polymarket-tracked person's article is a heavy hint.",
+      "method": "GET",
+      "path": "/w/api.php",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "action":     {"type": "string", "default": "query"},
+          "list":       {"type": "string", "default": "recentchanges"},
+          "rcprop":     {"type": "string", "default": "title|timestamp|comment|user|sizes|loginfo"},
+          "rclimit":    {"type": "integer", "description": "Max changes, default 50, max 500."},
+          "rctype":     {"type": "string", "description": "Filter: edit, new, log, categorize. Default: all."},
+          "rctitles":   {"type": "string", "description": "Pipe-separated specific titles to filter (much more useful for monitoring than the full firehose)."},
+          "rcnamespace":{"type": "integer", "description": "0=articles, 1=talk, 6=files. Most cases want 0."},
+          "format":     {"type": "string", "default": "json"}
+        }
+      }
+    },
+    {
+      "name": "page_revisions",
+      "description": "Edit history for one article. Returns timestamp, user, comment, and diff-size for each revision. Use to spot when an article got updated AND who/why — sometimes the edit comment carries the news context ('add 2026 election win').",
+      "method": "GET",
+      "path": "/w/api.php",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "action":   {"type": "string", "default": "query"},
+          "prop":     {"type": "string", "default": "revisions"},
+          "titles":   {"type": "string", "description": "Pipe-separated titles."},
+          "rvlimit":  {"type": "integer", "description": "Max revisions per title, default 10."},
+          "rvprop":   {"type": "string", "default": "timestamp|user|comment|size"},
+          "format":   {"type": "string", "default": "json"}
+        },
+        "required": ["titles"]
+      }
+    },
+    {
+      "name": "page_views",
+      "description": "Pageview statistics for an article over a date range — a noisy but real proxy for public attention. Spikes correlate with newsworthiness (death, scandal, breaking story).",
+      "method": "GET",
+      "path": "/api/rest_v1/metrics/pageviews/per-article/en.wikipedia/all-access/all-agents/{article}/{granularity}/{start}/{end}",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "article":     {"type": "string", "description": "Article title, URL-encoded."},
+          "granularity": {"type": "string", "enum": ["daily","monthly"], "default": "daily"},
+          "start":       {"type": "string", "description": "YYYYMMDD00."},
+          "end":         {"type": "string", "description": "YYYYMMDD00."}
+        },
+        "required": ["article","start","end"]
+      }
+    }
+  ],
+  "health_check": {
+    "tool": "page_summary",
+    "args": {"title": "Federal_Reserve"}
+  }
+}

package/src/apps/workos.json

@@ -0,0 +1,123 @@
+{
+  "slug": "workos",
+  "name": "WorkOS",
+  "description": "MCP server for WorkOS - SSO, directory sync, organizations, users, audit logs",
+  "logo": "https://www.google.com/s2/favicons?domain=workos.com&sz=128",
+  "categories": ["auth", "identity", "sso", "enterprise"],
+  "base_url": "https://api.workos.com",
+  "auth": {
+    "types": ["bearer"],
+    "headers": { "Authorization": "Bearer {{token}}" },
+    "credential_fields": [
+      { "name": "token", "label": "API Key" },
+      { "name": "clientId", "label": "Client ID" }
+    ]
+  },
+  "tools": [
+    {
+      "name": "list_organizations",
+      "description": "List organizations",
+      "method": "GET",
+      "path": "/organizations",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "domains": { "type": "array" },
+          "limit": { "type": "number" }
+        }
+      }
+    },
+    {
+      "name": "create_organization",
+      "description": "Create an organization",
+      "method": "POST",
+      "path": "/organizations",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "name": { "type": "string" },
+          "domains": { "type": "array" },
+          "domain_data": { "type": "array" }
+        },
+        "required": ["name"]
+      }
+    },
+    {
+      "name": "list_users",
+      "description": "List users (User Management)",
+      "method": "GET",
+      "path": "/user_management/users",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "email": { "type": "string" },
+          "organization_id": { "type": "string" }
+        }
+      }
+    },
+    {
+      "name": "get_user",
+      "description": "Get a user",
+      "method": "GET",
+      "path": "/user_management/users/{id}",
+      "input_schema": {
+        "type": "object",
+        "properties": { "id": { "type": "string" } },
+        "required": ["id"]
+      }
+    },
+    {
+      "name": "authenticate_with_code",
+      "description": "Exchange an auth code for a session",
+      "method": "POST",
+      "path": "/user_management/authenticate",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "client_id": { "type": "string" },
+          "client_secret": { "type": "string" },
+          "grant_type": { "type": "string" },
+          "code": { "type": "string" }
+        },
+        "required": ["client_id", "client_secret", "grant_type", "code"]
+      }
+    },
+    {
+      "name": "list_directories",
+      "description": "List Directory Sync directories",
+      "method": "GET",
+      "path": "/directories",
+      "input_schema": {
+        "type": "object",
+        "properties": { "organization_id": { "type": "string" } }
+      }
+    },
+    {
+      "name": "list_directory_users",
+      "description": "List users from a directory",
+      "method": "GET",
+      "path": "/directory_users",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "directory": { "type": "string" },
+          "group": { "type": "string" }
+        }
+      }
+    },
+    {
+      "name": "send_audit_log_event",
+      "description": "Send an audit log event",
+      "method": "POST",
+      "path": "/audit_logs/events",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "organization_id": { "type": "string" },
+          "event": { "type": "object" }
+        },
+        "required": ["organization_id", "event"]
+      }
+    }
+  ]
+}

package/src/apps/yahoo-dsp.json

@@ -0,0 +1,265 @@
+{
+  "slug": "yahoo-dsp",
+  "name": "Yahoo DSP",
+  "description": "Yahoo DSP API — manage advertisers, campaigns, line items (insertion orders), ads, audiences, and pull performance reports for Yahoo's programmatic DSP (formerly Verizon Media DSP / Oath / BrightRoll). Auth via Yahoo OAuth2; partners use a separate developer app from regular Yahoo APIs.",
+  "logo": "https://www.google.com/s2/favicons?domain=yahooinc.com&sz=128",
+  "categories": [
+    "advertising",
+    "marketing",
+    "campaigns",
+    "dsp",
+    "programmatic",
+    "yahoo",
+    "video-ads",
+    "display-ads"
+  ],
+  "base_url": "https://dspapi.admanagerplus.yahoo.com/traffic",
+  "auth": {
+    "types": [
+      "bearer",
+      "oauth2"
+    ],
+    "headers": {
+      "Authorization": "Bearer {{token}}",
+      "X-Auth-Method": "OAuth2",
+      "Content-Type": "application/json"
+    },
+    "credential_fields": [
+      {
+        "name": "token",
+        "label": "access_token",
+        "type": "password"
+      },
+      {
+        "name": "refresh_token",
+        "label": "refresh_token",
+        "type": "password"
+      },
+      {
+        "name": "expires_in",
+        "label": "expires_in"
+      },
+      {
+        "name": "advertiser_id",
+        "label": "Default Advertiser ID"
+      }
+    ],
+    "oauth2": {
+      "authorize_url": "https://api.login.yahoo.com/oauth2/request_auth",
+      "token_url": "https://api.login.yahoo.com/oauth2/get_token",
+      "scopes": [
+        "dsp-api-read",
+        "dsp-api-write"
+      ],
+      "client_id_required": true,
+      "pkce": false
+    }
+  },
+  "tools": [
+    {
+      "name": "list_advertisers",
+      "description": "List advertisers the authenticated user can access.",
+      "method": "GET",
+      "path": "/advertiser",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "limit": { "type": "integer", "default": 100 },
+          "offset": { "type": "integer", "default": 0 }
+        }
+      }
+    },
+    {
+      "name": "list_campaigns",
+      "description": "List campaigns under an advertiser.",
+      "method": "GET",
+      "path": "/campaign",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "advertiserId": { "type": "integer" },
+          "status": { "type": "string", "enum": ["ACTIVE", "INACTIVE", "PAUSED"] },
+          "limit": { "type": "integer", "default": 100 },
+          "offset": { "type": "integer", "default": 0 }
+        },
+        "required": ["advertiserId"]
+      }
+    },
+    {
+      "name": "create_campaign",
+      "description": "Create a campaign. Required: advertiserId, name, status (ACTIVE|INACTIVE), budget {amount, type: TOTAL|DAILY, currency}, pacing (FRONTLOADED|EVEN|ASAP), startDate (yyyy-MM-dd), endDate, objective (REACH|VIEWABILITY|VIDEO_COMPLETION|CTR|CPA|ROAS).",
+      "method": "POST",
+      "path": "/campaign",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "advertiserId": { "type": "integer" },
+          "name": { "type": "string" },
+          "status": { "type": "string", "enum": ["ACTIVE", "INACTIVE"], "default": "INACTIVE" },
+          "budget": { "type": "object" },
+          "pacing": { "type": "string", "enum": ["FRONTLOADED", "EVEN", "ASAP"], "default": "EVEN" },
+          "startDate": { "type": "string" },
+          "endDate": { "type": "string" },
+          "objective": { "type": "string" },
+          "channel": { "type": "string", "enum": ["DISPLAY", "VIDEO", "AUDIO", "NATIVE"] }
+        },
+        "required": ["advertiserId", "name", "budget", "startDate", "endDate"]
+      }
+    },
+    {
+      "name": "update_campaign",
+      "description": "Update a campaign by id.",
+      "method": "PUT",
+      "path": "/campaign/{campaignId}",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "campaignId": { "type": "integer" },
+          "name": { "type": "string" },
+          "status": { "type": "string", "enum": ["ACTIVE", "INACTIVE"] },
+          "budget": { "type": "object" },
+          "endDate": { "type": "string" }
+        },
+        "required": ["campaignId"]
+      }
+    },
+    {
+      "name": "list_line_items",
+      "description": "List line items under a campaign or advertiser.",
+      "method": "GET",
+      "path": "/lineitem",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "campaignId": { "type": "integer" },
+          "advertiserId": { "type": "integer" },
+          "status": { "type": "string", "enum": ["ACTIVE", "INACTIVE", "PAUSED"] },
+          "limit": { "type": "integer", "default": 100 },
+          "offset": { "type": "integer", "default": 0 }
+        }
+      }
+    },
+    {
+      "name": "create_line_item",
+      "description": "Create a line item. Required: campaignId, name, status, budget {amount, type, currency}, pacing, startDate, endDate, bidStrategy {type: FIXED|AUTOMATIC|MAX_CPM|MAX_CPC, value?}, lineItemType (DISPLAY|VIDEO|NATIVE|AUDIO), targeting object, frequencyCap {impressions, period}.",
+      "method": "POST",
+      "path": "/lineitem",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "campaignId": { "type": "integer" },
+          "name": { "type": "string" },
+          "status": { "type": "string", "enum": ["ACTIVE", "INACTIVE"], "default": "INACTIVE" },
+          "budget": { "type": "object" },
+          "pacing": { "type": "string", "enum": ["FRONTLOADED", "EVEN", "ASAP"] },
+          "startDate": { "type": "string" },
+          "endDate": { "type": "string" },
+          "bidStrategy": { "type": "object" },
+          "lineItemType": { "type": "string", "enum": ["DISPLAY", "VIDEO", "NATIVE", "AUDIO"] },
+          "targeting": { "type": "object" },
+          "frequencyCap": { "type": "object" }
+        },
+        "required": ["campaignId", "name", "budget", "startDate", "endDate", "bidStrategy", "lineItemType"]
+      }
+    },
+    {
+      "name": "list_ads",
+      "description": "List ads under a line item or advertiser.",
+      "method": "GET",
+      "path": "/ad",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "lineItemId": { "type": "integer" },
+          "advertiserId": { "type": "integer" },
+          "status": { "type": "string" },
+          "limit": { "type": "integer", "default": 100 },
+          "offset": { "type": "integer", "default": 0 }
+        }
+      }
+    },
+    {
+      "name": "create_ad",
+      "description": "Create an ad / creative association. Required: lineItemId, name, status, creativeId (the pre-uploaded creative asset).",
+      "method": "POST",
+      "path": "/ad",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "lineItemId": { "type": "integer" },
+          "name": { "type": "string" },
+          "status": { "type": "string", "enum": ["ACTIVE", "INACTIVE"], "default": "INACTIVE" },
+          "creativeId": { "type": "integer" },
+          "clickUrl": { "type": "string" }
+        },
+        "required": ["lineItemId", "name", "creativeId"]
+      }
+    },
+    {
+      "name": "list_audiences",
+      "description": "List audiences for an advertiser. Audience types: PIXEL (site visitors), CUSTOMER_FILE (CRM upload), MODELED (lookalike), CONVERSION_TRACKER.",
+      "method": "GET",
+      "path": "/audience",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "advertiserId": { "type": "integer" },
+          "type": { "type": "string", "enum": ["PIXEL", "CUSTOMER_FILE", "MODELED", "CONVERSION_TRACKER"] },
+          "limit": { "type": "integer", "default": 100 },
+          "offset": { "type": "integer", "default": 0 }
+        },
+        "required": ["advertiserId"]
+      }
+    },
+    {
+      "name": "create_audience",
+      "description": "Create an audience. Required: advertiserId, name, type. PIXEL audiences need rules{}; CUSTOMER_FILE audiences require a follow-up upload to /audience/{id}/members.",
+      "method": "POST",
+      "path": "/audience",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "advertiserId": { "type": "integer" },
+          "name": { "type": "string" },
+          "type": { "type": "string", "enum": ["PIXEL", "CUSTOMER_FILE", "MODELED"] },
+          "rules": { "type": "object" },
+          "ttl": { "type": "integer", "description": "Membership lifetime in days" }
+        },
+        "required": ["advertiserId", "name", "type"]
+      }
+    },
+    {
+      "name": "submit_report",
+      "description": "Queue an async performance report. dimensions: ADVERTISER, CAMPAIGN, LINE_ITEM, AD, CREATIVE, DAY, WEEK, MONTH, COUNTRY, DEVICE, EXCHANGE, INVENTORY_SOURCE. metrics: impressions, clicks, ctr, spend, cpm, ecpm, video_starts, video_completes, conversions, post_click_conversions, post_view_conversions, viewable_impressions.",
+      "method": "POST",
+      "path": "/reportRequest",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "advertiserId": { "type": "integer" },
+          "name": { "type": "string" },
+          "dimensions": { "type": "array", "items": { "type": "string" } },
+          "metrics": { "type": "array", "items": { "type": "string" } },
+          "startDate": { "type": "string" },
+          "endDate": { "type": "string" },
+          "intervalSize": { "type": "string", "enum": ["DAY", "WEEK", "MONTH", "TOTAL"], "default": "DAY" },
+          "format": { "type": "string", "enum": ["JSON", "CSV", "GZIP_CSV"], "default": "JSON" }
+        },
+        "required": ["advertiserId", "dimensions", "metrics", "startDate", "endDate"]
+      }
+    },
+    {
+      "name": "get_report",
+      "description": "Poll a queued report by reportRequestId. When status=COMPLETED, fetch the result from downloadUrl (presigned, short TTL).",
+      "method": "GET",
+      "path": "/reportRequest/{reportRequestId}",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "reportRequestId": { "type": "string" }
+        },
+        "required": ["reportRequestId"]
+      }
+    }
+  ]
+}

package/src/apps/yahoo-finance.json

@@ -0,0 +1,60 @@
+{
+  "slug": "yahoo-finance",
+  "name": "Yahoo Finance",
+  "description": "Free, no-auth market data — stocks, ETFs, indices, currencies, and crypto. Backed by Yahoo's public chart endpoint, the same source the `yfinance` Python library uses. Use for stock quotes, historical OHLCV bars, and symbol search. Note: Yahoo's TOS prohibits unauthorized commercial use and they reserve the right to throttle or change the response shape at any time — best for development, demos, and consumer-grade workloads. For production-grade SLA-backed data, bind a paid provider (Alpaca Market Data, Polygon, IEX).",
+  "logo": "https://www.google.com/s2/favicons?domain=finance.yahoo.com&sz=128",
+  "categories": [
+    "finance",
+    "stocks",
+    "market-data",
+    "etf",
+    "yahoo",
+    "public"
+  ],
+  "base_url": "https://query1.finance.yahoo.com",
+  "auth": {
+    "types": ["none"],
+    "headers": {
+      "User-Agent": "Mozilla/5.0 (compatible; Apteva-Trading/0.4)",
+      "Accept": "application/json"
+    },
+    "credential_fields": []
+  },
+  "tools": [
+    {
+      "name": "stock_chart",
+      "description": "Get OHLCV bars + meta (current price, prev close, day range, market state) for a single symbol over a configurable range. Returns timestamps, open/high/low/close/volume arrays. Use for charting, historical analysis, or as a one-shot 'real-time quote' (the meta.regularMarketPrice carries the latest price). Range + interval combinations: 1d/5m, 5d/30m, 1mo/1h, 3mo/1d, 1y/1d, 5y/1wk, max/1mo.",
+      "method": "GET",
+      "path": "/v8/finance/chart/{symbol}",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "symbol":   {"type": "string", "description": "Ticker (AAPL, MSFT, ^GSPC for S&P500, BTC-USD, EURUSD=X)."},
+          "range":    {"type": "string", "enum": ["1d","5d","1mo","3mo","6mo","1y","2y","5y","10y","ytd","max"], "default": "1d"},
+          "interval": {"type": "string", "enum": ["1m","2m","5m","15m","30m","60m","90m","1h","1d","5d","1wk","1mo","3mo"], "default": "5m"},
+          "includePrePost": {"type": "boolean", "description": "Include pre/post-market data."}
+        },
+        "required": ["symbol"]
+      }
+    },
+    {
+      "name": "stock_search",
+      "description": "Search Yahoo's symbol directory by free-text query. Returns matching tickers with name + exchange + asset class. Use to resolve 'apple' → AAPL, 'sp500' → ^GSPC, 'btc' → BTC-USD, etc., before calling stock_chart.",
+      "method": "GET",
+      "path": "/v1/finance/search",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "q":          {"type": "string", "description": "Free-text query — company name or partial ticker."},
+          "quotesCount": {"type": "integer", "description": "Max symbol matches (default 10)."},
+          "newsCount":   {"type": "integer", "description": "Max news matches (default 0 — saves payload)."}
+        },
+        "required": ["q"]
+      }
+    }
+  ],
+  "health_check": {
+    "tool": "stock_chart",
+    "args": {"symbol": "AAPL", "range": "1d", "interval": "5m"}
+  }
+}