{ "data": { "a": { "slug": "postiz", "name": "Postiz API + MCP", "vendor": "Postiz (Gitroom)", "vendorUrl": "https://postiz.com", "kind": "http-api", "category": "social-media", "summary": "Open-source social scheduler (AGPL-3.0) for 34 platforms that you can self-host free or use as Postiz Cloud from $29 a month.", "url": "https://www.anchorterminal.com/tools/postiz", "markdownUrl": "https://www.anchorterminal.com/tools/postiz.md", "slimMarkdownUrl": "https://www.anchorterminal.com/tools/postiz.min.md", "jsonUrl": "https://www.anchorterminal.com/api/v1/tools/postiz.json", "dns": "postiz.grade.anchorterminal.com", "repo": "https://github.com/gitroomhq/postiz-app", "license": "AGPL-3.0", "transports": [ "http", "streamable-http" ], "remoteUrl": "https://api.postiz.com/public/v1", "packages": [ { "registry": "npm", "name": "@postiz/node" }, { "registry": "npm", "name": "postiz" } ], "auth": "mixed", "authNotes": "API key sent raw in the Authorization header (no Bearer prefix), or an OAuth app token prefixed pos_. The MCP accepts a Bearer header at /mcp, an OAuth flow at /mcp-oauth, or the key in the URL path at /mcp/{key}. Self-hosted instances need their own developer apps for each network.", "pricing": "paid", "pricingNotes": "Self-hosting is free under AGPL-3.0, but you register your own developer app with each network. Per the 1 October check, Postiz Cloud has no free plan (7-day trial, card policy not stated), Standard $29 a month or $23 billed yearly (5 channels), Team $39 or $31 (10), Pro $49 or $39 (30), Ultimate $99 or $79 (100), with API, CLI, webhooks and MCP on every plan and posts unlimited. The terms of 19 October 2026 refund at most one month's fee per account, within 120 days, and never annual charges (https://postiz.com/terms-of-service).", "priceSummary": "$29 / mo", "where": "hosted", "x402": { "level": "no", "evidence": "No x402 in docs, llms.txt or pricing (checked 2026-09-30).", "endpoints": [] }, "toolCount": 13, "popularity": { "githubStars": 36531, "npmWeekly": 368, "pypiWeekly": null, "asOf": "2026-09-30" }, "docsUrl": "https://docs.postiz.com", "llmsTxt": "https://docs.postiz.com/llms.txt", "openapi": "https://docs.postiz.com/public-api/openapi.json", "capabilities": [ "social.post", "social.schedule", "social.analytics", "social.media-upload" ], "tags": [ "hosted", "self-hosted", "local", "open-source", "mcp", "llms-txt", "openapi", "typescript", "webhooks" ], "lastRelease": "2026-10-24", "graded": true, "anchor": { "graded": true, "score": 45.2, "grade": "E", "agentReady": false, "rank": 1201, "ranked": true, "rankOf": 1513, "categoryRank": 11, "methodology": "0.7", "run": "2026-10-01", "scores": { "ergonomics": 65, "maintenance": 83, "payments": 30, "reliability": 43, "schema": 88, "security": 49, "transparency": 82 }, "pending": [ "performance", "tasks" ], "assessment": { "confidence": "medium", "date": "2026-11-04" }, "negative": -15, "negativeNotes": [ "2026-03-27 to 2026-10-24. Postiz, its own CVE Numbering Authority, published 20 advisories in the 12 months, all fixed in releases, counted one by one at this run's values. Within two months of publication, CVE-2026-94456 (Critical) and CVE-2026-94455 (High, 22 September), CVE-2026-107761 (11 October, organisation key exposed in API responses) and CVE-2026-115931, -115932 and -115933 (Critical, 23 and 24 October, file reads and forged tokens taking over other organisations, fixed in v2.25.2 and v2.25.3) cost 11. Fourteen published from 27 March to 7 August (among them CVE-2026-19264, the unauthenticated /uploads path traversal, and CVE-2026-48781, a cross-tenant takeover) cost 14. The total passes the -15 floor (https://osv.dev/vulnerability/CVE-2026-115933, https://github.com/gitroomhq/postiz-app/blob/main/SECURITY.md)", "2026-10-15. v2.25.2 fixed a login open redirect through which a returnUrl using the javascript scheme could run script on the Postiz origin (commit 9a88959), and \"ssrf fixes\" (5f18f1c), with no advisory found in OSV. A released fix of the product's own described flaw with no advisory is a separate -3, inside the floor (https://github.com/gitroomhq/postiz-app/commit/9a88959839f92ad5d7ecabea300b3186272cebb3)" ], "verdict": "AGPL-3.0 and self-hostable with the API and MCP included, 34 platforms, with annotated MCP tools in the source. Postiz published 20 security advisories between March and October 2026, three of them Critical in late October, all fixed in releases. Create-post is capped at 90 requests an hour on every Cloud plan.", "bestFor": "Teams that want to self-host, or want 34 platforms including Mastodon, Farcaster, Discord and Slack on a flat plan.", "strengths": [ "AGPL-3.0 and self-hostable with the API and MCP included, 34 platforms", "OpenAPI 3.1 spec with 27 paths, llms.txt and Markdown docs, per the 1 October check", "MCP tools in source carry readOnlyHint, destructiveHint and idempotentHint, with when-not-to-use guidance", "Five releases from 22 September to 24 October 2026, and advisories published with CVEs through its own disclosure process", "Analytics and error reporting in the self-hosted build stay off unless their environment variables are set" ], "weaknesses": [ "20 security advisories between March and October 2026, including cross-tenant takeovers and file reads", "One organisation key with no scopes, and the MCP OAuth grant is always read and write", "The docs document the API key in the MCP URL path at /mcp/{key}", "No idempotency key and no Retry-After guidance", "Create-post capped at 90 requests an hour on every Cloud plan" ], "agentNotes": [ "Send the key as the `Authorization` header with no `Bearer` prefix on REST calls", "Batch several posts into one create request to stay under 90 an hour", "Call integrationSchema (Get Settings) for a channel before scheduling, since each network has its own settings", "Use the Bearer header on /mcp rather than /mcp/{key} so the key stays out of logs", "Run v2.25.3 or later when self-hosting, since earlier versions carry three Critical advisories published on 23 and 24 October 2026" ], "metrics": { "kind": "remote", "measured": false }, "reviewCount": 2, "avgRating": 3, "history": [ { "basis": "public evidence", "confidence": "medium", "grade": "E", "methodology": "0.7", "pending": [ "performance", "tasks" ], "run": "2026-10-01", "runLabel": "October 2026 research run", "score": 45.2 } ], "editorialScores": { "ergonomics": 65, "maintenance": 83, "payments": 30, "reliability": 43, "schema": 88, "security": 49, "transparency": 75 }, "provenanceScore": 89, "checked": { "categories": { "ergonomics": "2026-11-04", "maintenance": "2026-11-04", "payments": "2026-11-04", "reliability": "2026-11-04", "schema": "2026-11-04", "security": "2026-11-04", "transparency": "2026-11-04" }, "last": "2026-11-04", "lastMoved": "2026-11-04", "oldest": "2026-11-04", "stale": false, "staleAfterDays": 90 } }, "connect": { "http": "curl https://api.postiz.com/public/v1/integrations -H \"Authorization: $POSTIZ_API_KEY\"", "claudeCode": "claude mcp add --transport http postiz https://mcp.postiz.com/mcp --header \"Authorization: Bearer $POSTIZ_API_KEY\"" }, "letme": { "capability": "https://letme.dev/social.post", "tool": "https://letme.dev/postiz" }, "area": "communication", "unitPrices": [ { "item": "Standard plan", "unit": "month", "usd": 29, "note": "5 channels. $278 a year" }, { "item": "Team plan", "unit": "month", "usd": 39, "note": "10 channels. $374 a year" }, { "item": "Pro plan", "unit": "month", "usd": 49, "note": "30 channels. $470 a year" }, { "item": "Ultimate plan", "unit": "month", "usd": 99, "note": "100 channels. $950 a year" } ], "provenance": { "legalEntity": "Gitroom Limited", "domain": "postiz.com", "domainRegistered": "2013-06-24", "domainNote": "postiz.com was registered in 2013, well before the project started in 2023.", "endpointOnVendorDomain": true, "terms": "https://postiz.com/terms-of-service", "privacy": "https://postiz.com/privacy-policy", "statusPage": "https://status.postiz.com", "changelog": "https://github.com/gitroomhq/postiz-app/releases", "securityTxt": "none", "checked": "2026-09-30", "notes": [ "Terms name Gitroom Limited (seller of paid plans) and Gitroom LLC together as Postiz" ], "score": 89 }, "pageJsonUrl": "https://www.anchorterminal.com/tools/postiz.json", "live": { "slug": "postiz", "probe": { "target": "https://api.postiz.com/public/v1", "method": "get", "lastAt": "2026-11-09T01:53:19.447841229Z", "lastOk": true, "lastStatus": 404, "lastMs": 300, "authRequired": false, "uptime24h": 100, "uptime30d": 99.67, "p50ms24h": 305, "p95ms24h": 401, "samples24h": 244, "samples30d": 7689, "days": [ { "date": "2026-10-09", "probes": 250, "ok": 250 }, { "date": "2026-10-10", "probes": 247, "ok": 247 }, { "date": "2026-10-11", "probes": 247, "ok": 247 }, { "date": "2026-10-12", "probes": 247, "ok": 247 }, { "date": "2026-10-13", "probes": 248, "ok": 248 }, { "date": "2026-10-14", "probes": 249, "ok": 249 }, { "date": "2026-10-15", "probes": 253, "ok": 253 }, { "date": "2026-10-16", "probes": 252, "ok": 252 }, { "date": "2026-10-17", "probes": 253, "ok": 253 }, { "date": "2026-10-18", "probes": 256, "ok": 256 }, { "date": "2026-10-19", "probes": 255, "ok": 254 }, { "date": "2026-10-20", "probes": 252, "ok": 252 }, { "date": "2026-10-21", "probes": 253, "ok": 253 }, { "date": "2026-10-22", "probes": 253, "ok": 253 }, { "date": "2026-10-23", "probes": 248, "ok": 248 }, { "date": "2026-10-24", "probes": 251, "ok": 251 }, { "date": "2026-10-25", "probes": 250, "ok": 250 }, { "date": "2026-10-26", "probes": 252, "ok": 248 }, { "date": "2026-10-27", "probes": 249, "ok": 249 }, { "date": "2026-10-28", "probes": 250, "ok": 250 }, { "date": "2026-10-29", "probes": 249, "ok": 248 }, { "date": "2026-10-30", "probes": 249, "ok": 246 }, { "date": "2026-10-31", "probes": 251, "ok": 250 }, { "date": "2026-11-01", "probes": 249, "ok": 234 }, { "date": "2026-11-02", "probes": 250, "ok": 250 }, { "date": "2026-11-03", "probes": 248, "ok": 248 }, { "date": "2026-11-04", "probes": 246, "ok": 246 }, { "date": "2026-11-05", "probes": 185, "ok": 185 }, { "date": "2026-11-06", "probes": 241, "ok": 241 }, { "date": "2026-11-07", "probes": 243, "ok": 243 }, { "date": "2026-11-08", "probes": 243, "ok": 243 }, { "date": "2026-11-09", "probes": 20, "ok": 20 } ], "outages": [ { "start": "2026-11-01T00:54:51.402069554Z", "end": "2026-11-01T02:20:29.804585001Z", "note": "DNS lookup failed" } ], "since": "2026-10-08T00:00:00Z" }, "vendorStatus": { "page": "https://status.postiz.com", "indicator": "unknown", "summary": "no machine-readable status found", "checkedAt": "2026-11-08T17:50:14.335666693Z" }, "versions": [ { "registry": "github", "name": "gitroomhq/postiz-app", "version": "v2.25.3", "released": "2026-10-24", "seenAt": "2026-11-08T01:29:22.776904919Z" }, { "registry": "npm", "name": "@postiz/node", "version": "1.0.8", "seenAt": "2026-11-08T01:29:20.593801761Z" }, { "registry": "npm", "name": "postiz", "version": "2.0.27", "seenAt": "2026-11-08T01:29:21.403198126Z" } ], "githubStars": 41088, "npmWeekly": 100, "securityTxt": { "url": "https://postiz.com/.well-known/security.txt", "state": "none", "checkedAt": "2026-11-08T16:03:58.676355743Z" }, "llmsTxt": { "url": "https://docs.postiz.com/llms.txt", "ok": true, "status": 200, "checkedAt": "2026-11-08T15:37:11.488601655Z" }, "domain": { "domain": "postiz.com", "registered": "2013-06-24", "source": "https://rdap.verisign.com/com/v1/domain/postiz.com", "checkedAt": "2026-11-08T15:02:33.544634643Z" }, "pages": [ { "url": "https://postiz.com/pricing", "kind": "pricing", "status": 200, "checkedAt": "2026-11-04T08:30:23.777534373Z", "changedAt": "2026-10-15T21:32:23.048080477Z", "fingerprint": "603523fd803e" }, { "url": "https://postiz.com/privacy-policy", "kind": "privacy", "status": 200, "checkedAt": "2026-11-08T15:08:45.315847401Z", "changedAt": "2026-10-20T00:03:52.176361053Z", "fingerprint": "1698159242ba" }, { "url": "https://postiz.com/terms-of-service", "kind": "terms", "status": 200, "checkedAt": "2026-11-08T15:08:47.761610225Z", "changedAt": "2026-10-20T00:03:54.183695942Z", "fingerprint": "418d2edbefbd" } ], "mcpTools": { "url": "https://mcp.postiz.com/mcp", "checkedAt": "2026-11-08T02:00:41.314105887Z", "status": "auth", "note": "asks for credentials before listing its tools", "changedAt": "2026-11-07T01:46:54.699000256Z" }, "github": { "repo": "gitroomhq/postiz-app", "checkedAt": "2026-11-02T08:50:52.615357936Z", "stars": 40634, "archived": false, "issuesEnabled": true, "pushedAt": "2026-11-01T13:14:27Z", "openIssues": 132, "openPRs": 83, "issuesOpened90d": 92, "issuesClosed90d": 111, "prsMerged90d": 243, "ci": { "branch": "main", "runs": 50, "success": 38, "failure": 12, "other": 0, "latest": "success", "latestAt": "2026-11-01T13:02:31Z" }, "advisories": [ { "ghsa": "GHSA-629m-99qx-356r", "cve": "CVE-2026-94455", "severity": "high", "published": "2026-09-22T16:16:49Z" }, { "ghsa": "GHSA-4hw5-43cf-g9wp", "cve": "CVE-2026-94456", "severity": "critical", "published": "2026-09-22T14:19:29Z" }, { "ghsa": "GHSA-4hgh-5rhf-4qpm", "severity": "critical", "published": "2026-08-07T14:15:54Z" }, { "ghsa": "GHSA-5m7p-wphr-xjp7", "cve": "CVE-2026-19127", "severity": "medium", "published": "2026-08-06T17:28:44Z" }, { "ghsa": "GHSA-j7rp-5mgj-qgg9", "cve": "CVE-2026-48799", "severity": "high", "published": "2026-05-23T12:24:21Z" }, { "ghsa": "GHSA-v4wr-4j8g-4hfj", "cve": "CVE-2026-48783", "severity": "medium", "published": "2026-05-22T18:55:41Z" }, { "ghsa": "GHSA-j77w-h625-56q2", "cve": "CVE-2026-48781", "severity": "critical", "published": "2026-05-22T18:28:38Z" }, { "ghsa": "GHSA-f7jj-p389-4w45", "cve": "CVE-2026-42346", "severity": "medium", "published": "2026-04-28T12:20:41Z" }, { "ghsa": "GHSA-jxg2-2cmf-h66m", "severity": "medium", "published": "2026-04-28T12:18:58Z" }, { "ghsa": "GHSA-hhxq-3wg7-4rj8", "cve": "CVE-2026-42556", "severity": "high", "published": "2026-04-27T19:34:49Z" }, { "ghsa": "GHSA-v975-9h5p-xhm4", "cve": "CVE-2026-42298", "severity": "critical", "published": "2026-04-22T14:22:06Z" }, { "ghsa": "GHSA-44wg-r34q-hvfx", "cve": "CVE-2026-40487", "severity": "critical", "published": "2026-04-12T04:07:21Z" }, { "ghsa": "GHSA-34w8-5j2v-h6ww", "cve": "CVE-2026-40168", "severity": "high", "published": "2026-04-09T12:21:20Z" }, { "ghsa": "GHSA-wc9c-7cv8-m225", "cve": "CVE-2026-34590", "severity": "medium", "published": "2026-03-29T16:00:06Z" }, { "ghsa": "GHSA-89vp-m2qw-7v34", "cve": "CVE-2026-34576", "severity": "medium", "published": "2026-03-29T07:15:39Z" }, { "ghsa": "GHSA-mv6h-v3jg-g539", "cve": "CVE-2026-34577", "severity": "high", "published": "2026-03-29T07:15:27Z" }, { "ghsa": "GHSA-89v5-38xr-9m4j", "severity": "high", "published": "2026-03-25T10:48:29Z" }, { "ghsa": "GHSA-vj2p-7pgw-g2wf", "cve": "CVE-2024-34351", "severity": "high", "published": "2026-03-25T10:15:46Z" }, { "ghsa": "GHSA-48c8-25jq-m55f", "cve": "CVE-2025-53641", "severity": "high", "published": "2025-07-11T16:15:50Z" } ], "replies": { "sampled": 25, "unanswered": 22, "medianDays": 0.1 } }, "updatedAt": "2026-11-09T01:53:19.447841229Z" }, "streak": { "days": 8, "from": "2026-11-01", "last": { "kind": "outage", "date": "2026-11-01", "what": "DNS lookup failed", "lasted": "1 hour" }, "best": 24 } }, "answer": "Postiz API + MCP scores 45.2 (E) on agent readiness against Xpoz MCP's 39.6 (E), and leads in 6 of 7 scored categories.", "b": { "slug": "xpoz-mcp", "name": "Xpoz MCP", "vendor": "XPOZ", "vendorUrl": "https://xpoz.ai", "kind": "mcp", "category": "social-media", "summary": "Xpoz's hosted MCP server gives an agent 52 tools to search posts and profiles on X, Instagram, TikTok and Reddit, track brands and competitors and analyse engagement, with an API key and no platform API keys of its own.", "url": "https://www.anchorterminal.com/tools/xpoz-mcp", "markdownUrl": "https://www.anchorterminal.com/tools/xpoz-mcp.md", "slimMarkdownUrl": "https://www.anchorterminal.com/tools/xpoz-mcp.min.md", "jsonUrl": "https://www.anchorterminal.com/api/v1/tools/xpoz-mcp.json", "dns": "xpoz-mcp.grade.anchorterminal.com", "repo": "https://github.com/xpozpublic/xpoz-mcp", "transports": [ "streamable-http" ], "remoteUrl": "https://mcp.xpoz.ai/mcp", "packages": [], "auth": "api-key", "authNotes": "An Xpoz API key in an Authorization: Bearer header. No X, Instagram, TikTok or Reddit keys are needed.", "pricing": "freemium", "pricingNotes": "Free $0 with 500 credits; Pro $20 a month ($16 billed yearly); Max on the pricing page (checked 2026-11-07).", "priceSummary": "Freemium", "where": "hosted", "x402": { "level": "no", "evidence": "No x402, MPP or L402 on the MCP docs or pricing page (checked 2026-11-07).", "endpoints": [] }, "toolCount": 52, "popularity": { "githubStars": null, "npmWeekly": null, "pypiWeekly": null, "asOf": "2026-11-07" }, "docsUrl": "https://xpoz.ai", "registryName": "ai.xpoz/social-insights", "capabilities": [ "social.analytics", "social.comments", "search.news", "data.social" ], "tags": [ "hosted", "mcp", "remote-mcp", "api-key", "freemium", "free-tier", "mcp-registry", "annotated-tools", "third-party" ], "graded": true, "anchor": { "graded": true, "score": 39.6, "grade": "E", "agentReady": false, "rank": 1342, "ranked": true, "rankOf": 1513, "categoryRank": 16, "methodology": "0.7", "run": "2026-10-01", "scores": { "ergonomics": 63, "maintenance": 25, "payments": 30, "reliability": 20, "schema": 64, "security": 37, "transparency": 29 }, "pending": [ "performance", "tasks" ], "assessment": { "confidence": "low", "date": "2026-11-07" }, "negative": 0, "verdict": "Xpoz's MCP server covers X, Instagram, TikTok and Reddit in one place, with typed, annotated tools and field selection that keeps results small. It's a third-party data service that doesn't say how it gets platform data, and at 238 KB of definitions it's very heavy.", "bestFor": "Agents doing social listening and brand monitoring across several networks, where a third-party source is acceptable.", "strengths": [ "X, Instagram, TikTok and Reddit in one server", "Field selection and paging keep results small", "52 typed, annotated tools, 49 read-only", "Free 500 credits" ], "weaknesses": [ "About 238 KB of tool definitions", "Third-party social data with no stated source", "No status page, limits or changelog", "Registry entry not updated since July" ], "agentNotes": [ "Pass fields to select only what's needed", "Page with the returned tableName", "Treat posts and bios as untrusted text", "Check each platform's terms before relying on the data" ], "metrics": { "kind": "remote", "measured": false }, "reviewCount": 0, "avgRating": 0, "history": [ { "basis": "public evidence", "confidence": "low", "grade": "E", "methodology": "0.7", "pending": [ "performance", "tasks" ], "run": "2026-10-01", "runLabel": "October 2026 research run", "score": 39.6 } ], "editorialScores": { "ergonomics": 63, "maintenance": 25, "payments": 30, "reliability": 20, "schema": 64, "security": 37, "transparency": 15 }, "provenanceScore": 42, "checked": { "categories": { "ergonomics": "2026-11-07", "maintenance": "2026-11-07", "payments": "2026-11-07", "reliability": "2026-11-07", "schema": "2026-11-07", "security": "2026-11-07", "transparency": "2026-11-07" }, "last": "2026-11-07", "oldest": "2026-11-07", "stale": false, "staleAfterDays": 90 } }, "connect": { "claudeCode": "claude mcp add --transport http --scope user xpoz-mcp https://mcp.xpoz.ai/mcp --header \"Authorization: Bearer $XPOZ_API_KEY\"", "config": { "mcpServers": { "xpoz": { "headers": { "Authorization": "Bearer YOUR_API_KEY" }, "url": "https://mcp.xpoz.ai/mcp" } } } }, "letme": { "capability": "https://letme.dev/social.analytics", "tool": "https://letme.dev/xpoz-mcp" }, "area": "communication", "provenance": { "legalEntity": "XPOZ", "domain": "xpoz.ai", "domainRegistered": "", "domainNote": "Not looked up: RDAP isn't requested under the 1 November 2026 rules.", "endpointOnVendorDomain": true, "terms": "https://xpoz.ai/terms", "privacy": "", "statusPage": "", "changelog": "", "securityTxt": "none", "checked": "2026-11-07", "notes": [ "The terms of use don't name a legal entity in the parts read." ], "score": 42 }, "pageJsonUrl": "https://www.anchorterminal.com/tools/xpoz-mcp.json", "live": { "slug": "xpoz-mcp", "probe": { "target": "https://mcp.xpoz.ai/mcp", "method": "mcp-initialize", "lastAt": "2026-11-09T01:53:34.200739267Z", "lastOk": true, "lastStatus": 200, "lastMs": 106, "lastNote": "initialize answered", "authRequired": false, "uptime24h": 100, "uptime30d": 100, "p50ms24h": 85, "p95ms24h": 161, "samples24h": 244, "samples30d": 316, "days": [ { "date": "2026-11-07", "probes": 53, "ok": 53 }, { "date": "2026-11-08", "probes": 243, "ok": 243 }, { "date": "2026-11-09", "probes": 20, "ok": 20 } ], "since": "2026-11-07T00:00:00Z" }, "versions": [ { "registry": "mcp-registry", "name": "ai.xpoz/social-insights", "version": "1.4.1", "seenAt": "2026-11-08T18:37:59.431193162Z" } ], "githubStars": 13, "securityTxt": { "url": "https://xpoz.ai/.well-known/security.txt", "state": "none", "checkedAt": "2026-11-08T16:03:59.850593363Z" }, "domain": { "domain": "xpoz.ai", "registered": "2023-10-19", "source": "https://rdap.identitydigital.services/rdap/domain/xpoz.ai", "checkedAt": "2026-11-08T15:09:38.861542265Z" }, "pages": [ { "url": "https://xpoz.ai/terms", "kind": "terms", "status": 200, "checkedAt": "2026-11-08T15:29:16.858495366Z", "changedAt": "0001-01-01T00:00:00Z", "fingerprint": "a92deb1e9024" } ], "mcpTools": { "url": "https://mcp.xpoz.ai/mcp", "checkedAt": "2026-11-08T02:03:10.124135678Z", "status": "ok", "protocol": "2025-06-18", "tools": [ { "name": "getTwitterUsers", "description": "Get one or more Twitter user profiles by IDs or usernames (1-100 per request). Use identifierType=\"id\" for numeric user IDs, identifierType=\"username\" for usernames. All identifiers must be the same type. For single user: pass array of 1, e.g. identifiers=[\"elonmusk\"]. For person names or fuzzy search, use searchTwitterUsers instead. PERFORMANCE: More efficient than multiple single calls, but can still take time for many users. Returns only found users, omitting not-found identifiers for flexibility. Optional fields parameter for performance (default: [\"id\", \"username\", \"name\"]). Available fields: id, profileImageUrl, profileBannerUrl, profileInterstitialType, status, username, verifiedType, name, description, location, protected, verified, followersCount, followingCount, tweetCount, listedCount, likesCount, mediaCount, pinnedTweetId, source, nLang, nLangsFiltered, label, labelType, isVerified, modifiedAt, createdAt, verifiedSinceDatetime, accountBasedIn, locationAccurate, usernameChanges, lastUsernameChangeDatetime. NOTE: Use \"tweetCount\" not \"statusesCount\". Returns: array of user profiles with count and dataSource. This is a safe, read-only tool for analyzing searchable information. ", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "_isTrial": { "type": "boolean" }, "_requestId": { "type": "string" }, "_trialToken": { "type": "string" }, "feedback": { "description": "Optional. Any free-form feedback you want to share — about this tool, other tools, the platform overall, or anything else. Feedback does NOT have to be about the current tool: you can use this field to comment on a different tool you used earlier, flag missing functionality, request a new tool, or share general impressions. Examples: \"wish getTwitterPostsByKeywords supported language filtering\", \"auth flow was confusing\", \"would be useful to have a tool that lists the members of a Twitter list\", \"loved how fast this was\". Captured for product feedback; does not affect tool behavior.", "type": "string" }, "fields": { "description": "PERFORMANCE OPTIMIZATION: Specify fields you need. DEFAULT (if omitted): [\"id\", \"username\", \"name\"]. AVAILABLE FIELDS: Core: id, username, name, description, location, verified, verifiedType, protected. Engagement: followersCount, followingCount, tweetCount, listedCount, likesCount, mediaCount. Profile: profileImageUrl, profileBannerUrl, profileInterstitialType. Metadata: source, status, pinnedTweetId, isVerified, accountBasedIn, locationAccurate, label, labelType. Advanced: nLang, nLangsFiltered. Timestamps: modifiedAt, createdAt. Account History: verifiedSinceDatetime, usernameChanges, lastUsernameChangeDatetime. EXAMPLES: [\"id\", \"username\"] for minimal, [\"username\", \"name\", \"description, followersCount\"] for basic info, or specify all fields if needed.", "items": { "type": "string" }, "type": "array" }, "forceLatest": { "description": "USE SPARINGLY: Force fetching the latest data from the API, bypassing cache checks. Only use when explicitly required (e.g., \"get the latest\", \"most recent\", \"real-time\"). WARNING: Increases latency and API costs. Default: false (uses intelligent caching).", "type": "boolean" }, "identifierType": { "description": "Type of identifier provided. Use \"id\" for numeric user ID, \"username\" for username.", "enum": [ "id", "username" ], "type": "string" }, "identifiers": { "description": "Array of user IDs (numeric) or usernames (1-100). All must match identifierType. Examples: [\"elonmusk\", \"sama\"] for usernames, [\"44196397\", \"123456\"] for IDs. Returns only found users, omitting not-found identifiers.", "items": { "minLength": 1, "type": "string" }, "maxItems": 100, "minItems": 1, "type": "array" }, "userPrompt": { "description": "CRITICAL FOR ACCURACY: Include the complete user question to enable query optimization and context-aware filtering. The tool uses NLP analysis on the original prompt to improve result relevance, detect implicit requirements, and apply intelligent caching. Omitting this may result in suboptimal or incomplete results.", "type": "string" } }, "required": [ "identifiers", "identifierType" ], "type": "object" }, "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": true, "readOnlyHint": true, "title": "Twitter: Get Users" } }, { "name": "getTwitterUser", "description": "Get Twitter user profile by ID or username. Use identifierType=\"id\" for numeric user ID, identifierType=\"username\" for username. For username: Use ONLY when you have the precise username (e.g., \"elonmusk\"). For person names or fuzzy search, use searchTwitterUsers instead. Optional fields parameter for performance (default: [\"id\", \"username\", \"name\"]). Available fields: id, profileImageUrl, profileBannerUrl, profileInterstitialType, status, username, verifiedType, name, description, location, protected, verified, followersCount, followingCount, tweetCount, listedCount, likesCount, mediaCount, pinnedTweetId, source, nLang, nLangsFiltered, label, labelType, isVerified, modifiedAt, createdAt, verifiedSinceDatetime, accountBasedIn, locationAccurate, usernameChanges, lastUsernameChangeDatetime. NOTE: Use \"tweetCount\" not \"statusesCount\". Returns: single user profile with id, username, name, bio, followers_count, following_count, tweet_count, created_at, authenticity_score, inauthentic_type. This is a safe, read-only tool for analyzing searchable information. ", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "_isTrial": { "type": "boolean" }, "_requestId": { "type": "string" }, "_trialToken": { "type": "string" }, "feedback": { "description": "Optional. Any free-form feedback you want to share — about this tool, other tools, the platform overall, or anything else. Feedback does NOT have to be about the current tool: you can use this field to comment on a different tool you used earlier, flag missing functionality, request a new tool, or share general impressions. Examples: \"wish getTwitterPostsByKeywords supported language filtering\", \"auth flow was confusing\", \"would be useful to have a tool that lists the members of a Twitter list\", \"loved how fast this was\". Captured for product feedback; does not affect tool behavior.", "type": "string" }, "fields": { "description": "PERFORMANCE OPTIMIZATION: Specify fields you need. DEFAULT (if omitted): [\"id\", \"username\", \"name\"]. AVAILABLE FIELDS: Core: id, username, name, description, location, verified, verifiedType, protected. Engagement: followersCount, followingCount, tweetCount, listedCount, likesCount, mediaCount. Profile: profileImageUrl, profileBannerUrl, profileInterstitialType. Metadata: source, status, pinnedTweetId, isVerified, accountBasedIn, locationAccurate, label, labelType. Advanced: nLang, nLangsFiltered. Timestamps: modifiedAt, createdAt. Account History: verifiedSinceDatetime, usernameChanges, lastUsernameChangeDatetime. EXAMPLES: [\"id\", \"username\"] for minimal, [\"username\", \"name\", \"description, followersCount\"] for basic info, or specify all fields if needed.", "items": { "type": "string" }, "type": "array" }, "forceLatest": { "description": "USE SPARINGLY: Force fetching the latest data from the API, bypassing cache checks. Only use when explicitly required (e.g., \"get the latest\", \"most recent\", \"real-time\"). WARNING: Increases latency and API costs. Default: false (uses intelligent caching).", "type": "boolean" }, "identifier": { "description": "User ID (numeric) or username depending on identifierType.", "minLength": 1, "type": "string" }, "identifierType": { "description": "Type of identifier provided. Use \"id\" for numeric user ID, \"username\" for username.", "enum": [ "id", "username" ], "type": "string" }, "userPrompt": { "description": "CRITICAL FOR ACCURACY: Include the complete user question to enable query optimization and context-aware filtering. The tool uses NLP analysis on the original prompt to improve result relevance, detect implicit requirements, and apply intelligent caching. Omitting this may result in suboptimal or incomplete results.", "type": "string" } }, "required": [ "identifier", "identifierType" ], "type": "object" }, "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": true, "readOnlyHint": true, "title": "Twitter: Get User" } }, { "name": "searchTwitterUsers", "description": "Search users by person name, partial username, or fuzzy match using real-time external API. PRIMARY USE: When given person's name (e.g., \"Elon Musk\", \"Sam Altman\"), partial info, or uncertain username. Use for: Name-based search, finding multiple candidates, fuzzy matching, discovering users. NOT for: Exact username lookup (use getTwitterUser when username is certain). Optional fields parameter for performance (default: [\"id\", \"username\", \"name\"]). Available fields: id, username, name, description, location, followersCount, followingCount, verified, profileImageUrl, and more. Returns: array of matching users (default 10, max 10) with id, username, name, bio, followers_count. This is a safe, read-only tool for analyzing searchable information. ", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "_isTrial": { "type": "boolean" }, "_requestId": { "type": "string" }, "_trialToken": { "type": "string" }, "feedback": { "description": "Optional. Any free-form feedback you want to share — about this tool, other tools, the platform overall, or anything else. Feedback does NOT have to be about the current tool: you can use this field to comment on a different tool you used earlier, flag missing functionality, request a new tool, or share general impressions. Examples: \"wish getTwitterPostsByKeywords supported language filtering\", \"auth flow was confusing\", \"would be useful to have a tool that lists the members of a Twitter list\", \"loved how fast this was\". Captured for product feedback; does not affect tool behavior.", "type": "string" }, "fields": { "description": "PERFORMANCE OPTIMIZATION: Specify fields you need. DEFAULT (if omitted): [\"id\", \"username\", \"name\"]. AVAILABLE FIELDS: Core: id, username, name, description, location, verified, verifiedType, protected. Engagement: followersCount, followingCount, tweetCount, listedCount, likesCount, mediaCount. Profile: profileImageUrl, profileBannerUrl, profileInterstitialType. Metadata: source, status, pinnedTweetId, isVerified, accountBasedIn, locationAccurate, label, labelType. Advanced: nLang, nLangsFiltered. Timestamps: modifiedAt, createdAt. Account History: verifiedSinceDatetime, usernameChanges, lastUsernameChangeDatetime. EXAMPLES: [\"id\", \"username\"] for minimal, [\"username\", \"name\", \"description, followersCount\"] for basic info, or specify all fields if needed.", "items": { "type": "string" }, "type": "array" }, "limit": { "minimum": 1, "type": "number" }, "name": { "minLength": 1, "type": "string" }, "userPrompt": { "description": "CRITICAL FOR ACCURACY: Include the complete user question to enable query optimization and context-aware filtering. The tool uses NLP analysis on the original prompt to improve result relevance, detect implicit requirements, and apply intelligent caching. Omitting this may result in suboptimal or incomplete results.", "type": "string" } }, "required": [ "name" ], "type": "object" }, "annotations": { "destructiveHint": false, "idempotentHint": false, "openWorldHint": true, "readOnlyHint": true, "title": "Twitter: Search Users" } }, { "name": "getTwitterUserConnections", "description": "Get Twitter user connections (followers or following). Use connectionType=\"followers\" for users who follow them, connectionType=\"following\" for users they follow. FAST (default, omit responseType or responseType=\"fast\"): Returns up to 300 results directly (use limit param to reduce, e.g. limit=5). Auto API fallback for fresh data. PAGING (responseType=\"paging\"): Async paginated results (1000/page with default fields, 100/page with extra fields), returns operationId for polling via checkOperationStatus. Supports pageNumber/tableName for subsequent pages. CSV (responseType=\"csv\"): Async single CSV download, returns operationId, poll for S3 link. CODE EXECUTION: For csv mode, download CSV and use code execution to analyze full dataset. Ideal for: network analysis, audience demographics, engagement patterns. Optional fields parameter for performance (default: [\"id\", \"username\", \"name\"]). Available fields: id, username, name, description, location, followersCount, followingCount, verified, profileImageUrl, and more. DATA FRESHNESS: Automatically checks data age (\u003e 1 week triggers refresh from API). FORCE LATEST: Use sparingly - forceLatest=true bypasses cache for real-time data (increases latency/costs). CRITICAL - Understanding totalRows vs totalDataCount: totalRows indicates ONLY what we have in our database. totalDataCount (when present) shows the actual count from Twitter. If totalDataCount is missing or undefined, you CANNOT claim totalRows represents all connections - it only shows our partial database data. If totalDataCount \u003e totalRows, we only have partial data. Always check if totalDataCount exists before making claims about total counts. This is a safe, read-only tool for analyzing searchable information. ", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "_isTrial": { "type": "boolean" }, "_requestId": { "type": "string" }, "_trialToken": { "type": "string" }, "connectionType": { "description": "Type of connection to retrieve. Use \"followers\" for users who follow this account, \"following\" for users this account follows.", "enum": [ "followers", "following" ], "type": "string" }, "feedback": { "description": "Optional. Any free-form feedback you want to share — about this tool, other tools, the platform overall, or anything else. Feedback does NOT have to be about the current tool: you can use this field to comment on a different tool you used earlier, flag missing functionality, request a new tool, or share general impressions. Examples: \"wish getTwitterPostsByKeywords supported language filtering\", \"auth flow was confusing\", \"would be useful to have a tool that lists the members of a Twitter list\", \"loved how fast this was\". Captured for product feedback; does not affect tool behavior.", "type": "string" }, "fields": { "description": "PERFORMANCE OPTIMIZATION: Specify fields you need. DEFAULT (if omitted): [\"id\", \"username\", \"name\"]. AVAILABLE FIELDS: Core: id, username, name, description, location, verified, verifiedType, protected. Engagement: followersCount, followingCount, tweetCount, listedCount, likesCount, mediaCount. Profile: profileImageUrl, profileBannerUrl, profileInterstitialType. Metadata: source, status, pinnedTweetId, isVerified, accountBasedIn, locationAccurate, label, labelType. Advanced: nLang, nLangsFiltered. Timestamps: modifiedAt, createdAt. Account History: verifiedSinceDatetime, usernameChanges, lastUsernameChangeDatetime. EXAMPLES: [\"id\", \"username\"] for minimal, [\"username\", \"name\", \"description, followersCount\"] for basic info, or specify all fields if needed.", "items": { "type": "string" }, "type": "array" }, "forceLatest": { "description": "USE SPARINGLY: Force fetching the latest data from the API, bypassing cache checks. Only use when explicitly required (e.g., \"get the latest\", \"most recent\", \"real-time\"). WARNING: Increases latency and API costs. Default: false (uses intelligent caching).", "type": "boolean" }, "limit": { "description": "Max results to return. Fast mode: capped at 300 (default: 300). Paging/CSV modes: caps total exported rows (default: all, max 500K).", "maximum": 500000, "minimum": 1, "type": "number" }, "pageNumber": { "description": "Page number to fetch (1-indexed). Must be provided with tableName to fetch subsequent pages. Omit for first page.", "minimum": 1, "type": "number" }, "pageNumberEnd": { "description": "Optional ending page number for fetching multiple consecutive pages at once (e.g., pageNumber=1, pageNumberEnd=5 fetches pages 1-5). Must be \u003e= pageNumber. Omit to fetch single page only. Requires tableName.", "minimum": 1, "type": "number" }, "responseType": { "description": "Response mode. \"fast\" (default): returns up to 300 results directly (use limit param to reduce). \"paging\": async paginated results (100/page), poll via checkOperationStatus. \"csv\": async single CSV download, poll for S3 link.", "enum": [ "fast", "paging", "csv" ], "type": "string" }, "tableName": { "description": "Cached table name from previous pagination request. Required when fetching pageNumber \u003e 1. Returned in first page response.", "type": "string" }, "userPrompt": { "description": "CRITICAL FOR ACCURACY: Include the complete user question to enable query optimization and context-aware filtering. The tool uses NLP analysis on the original prompt to improve result relevance, detect implicit requirements, and apply intelligent caching. Omitting this may result in suboptimal or incomplete results.", "type": "string" }, "username": { "description": "Twitter username (without @ symbol).", "minLength": 1, "pattern": "^@?[a-zA-Z0-9_]{1,15}$", "type": "string" } }, "required": [ "username", "connectionType" ], "type": "object" }, "annotations": { "destructiveHint": false, "idempotentHint": false, "openWorldHint": true, "readOnlyHint": true, "title": "Twitter: Get User Connections" } }, { "name": "getTwitterUsersByKeywords", "description": "Search for USERS who authored tweets/comments/quotes/retweets matching keywords. USE CASE: Find users who have posted content about specific topics, keywords, or phrases. Returns unique, deduplicated user profiles. RESPONSE MODES (responseType parameter): \"fast\" (DEFAULT): Returns up to 300 results directly in one call. Use limit param to reduce. Best for quick lookups. \"paging\": Async paginated results (100/page). Returns operation ID - call checkOperationStatus to get results. Use pageNumber/tableName for subsequent pages. \"csv\": Async CSV export. Returns dataDumpExportOperationId - call checkOperationStatus to get S3 download link. Best for bulk export. PAGING MODE DETAILS: FIRST CALL: Omit pageNumber and tableName. Creates cached table, returns page 1 with pagination metadata (tableName, totalPages, totalRows). SUBSEQUENT PAGES: Use tableName from first response with pageNumber (2, 3, etc.). BULK FETCH: Use pageNumberEnd with pageNumber and tableName for multiple consecutive pages. QUERY SYNTAX: Plain keywords (bitcoin, climate change), quoted phrases (\"deep learning\"), boolean expressions (AI AND crypto, bitcoin OR ethereum, politics NOT sports), or parenthesized groups ((startup OR entrepreneur) NOT \"venture capital\"). AND/OR/NOT must have a term on both sides. @handles like @karpathy are supported. Field operators (from:, lang:) are stripped. Forward slashes are treated as spaces (24/7 becomes 24 7). FILTERS: - startDate/endDate: Filter by tweet date (YYYY-MM-DD format). OMIT by default, only use if user explicitly requests date range. \n IMPORTANT!!!!!: THE CURRENT YEAR IS 2026.\n When user requests relative dates (last week, last month), verify the current date from your \n system context and double-check the calculated dates - models often get the year wrong, searching one year earlier than intended. \n- language: Filter tweets by language (en, EN, English, es, Spanish, etc.). Optional fields parameter for performance (default: [\"id\", \"username\", \"name\"]). Available fields: id, username, name, description, location, followersCount, followingCount, verified, profileImageUrl, and more. AGGREGATE FIELDS (from matching tweets) - MUST BE EXPLICITLY REQUESTED IN FIELDS: aggRelevance (relevance score for sorting), relevantTweetsCount (count of matching tweets per user), relevantTweetsImpressionsSum, relevantTweetsLikesSum, relevantTweetsQuotesSum, relevantTweetsRepliesSum, relevantTweetsRetweetsSum. These return aggregated metrics from all matched tweets for each user. Returns: results array of unique user profiles, count. In paging mode: pagination object, dataDumpExportOperationId for CSV. This is a safe, read-only tool for analyzing searchable information. ", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "_isTrial": { "type": "boolean" }, "_requestId": { "type": "string" }, "_trialToken": { "type": "string" }, "endDate": { "type": "string" }, "feedback": { "description": "Optional. Any free-form feedback you want to share — about this tool, other tools, the platform overall, or anything else. Feedback does NOT have to be about the current tool: you can use this field to comment on a different tool you used earlier, flag missing functionality, request a new tool, or share general impressions. Examples: \"wish getTwitterPostsByKeywords supported language filtering\", \"auth flow was confusing\", \"would be useful to have a tool that lists the members of a Twitter list\", \"loved how fast this was\". Captured for product feedback; does not affect tool behavior.", "type": "string" }, "fields": { "description": "PERFORMANCE OPTIMIZATION: Specify fields you need. DEFAULT (if omitted): [\"id\", \"username\", \"name\"]. AVAILABLE FIELDS: Core: id, username, name, description, location, verified, verifiedType, protected. Engagement: followersCount, followingCount, tweetCount, listedCount, likesCount, mediaCount. Profile: profileImageUrl, profileBannerUrl, profileInterstitialType. Metadata: source, status, pinnedTweetId, isVerified, accountBasedIn, locationAccurate, label, labelType. Advanced: nLang, nLangsFiltered. Timestamps: modifiedAt, createdAt. Account History: verifiedSinceDatetime, usernameChanges, lastUsernameChangeDatetime. Aggregations (from matching tweets, not all tweets of the user): aggRelevance (relevance score), relevantTweetsCount (count of matching tweets), relevantTweetsImpressionsSum, relevantTweetsLikesSum, relevantTweetsQuotesSum, relevantTweetsRepliesSum, relevantTweetsRetweetsSum. EXAMPLES: [\"id\", \"username\"] for minimal, [\"username\", \"name\", \"followersCount\", \"relevantTweetsLikesSum\", \"relevantTweetsCount\"] to include engagement aggregations.", "items": { "type": "string" }, "type": "array" }, "forceLatest": { "description": "USE SPARINGLY: Force fetching the latest data from the API, bypassing cache checks. Only use when explicitly required (e.g., \"get the latest\", \"most recent\", \"real-time\"). WARNING: Increases latency and API costs. Default: false (uses intelligent caching).", "type": "boolean" }, "language": { "type": "string" }, "limit": { "description": "Max results to return. Fast mode: capped at 300 (default: 300). Paging/CSV modes: caps total exported rows (default: all, max 500K).", "maximum": 500000, "minimum": 1, "type": "number" }, "pageNumber": { "description": "Page number to fetch (1-indexed). Must be provided with tableName to fetch subsequent pages. Omit for first page.", "minimum": 1, "type": "number" }, "pageNumberEnd": { "description": "Optional ending page number for fetching multiple consecutive pages at once (e.g., pageNumber=1, pageNumberEnd=5 fetches pages 1-5). Must be \u003e= pageNumber. Omit to fetch single page only. Requires tableName.", "minimum": 1, "type": "number" }, "query": { "description": "Full-text search of tweet content to find users who authored matching posts. Searches tweets/comments/quotes/retweets, returns UNIQUE user authors (deduplicated). EXACT PHRASES: Wrap in double quotes - \"machine learning\" matches that exact phrase. KEYWORDS: Without quotes, matches posts containing any of the words - AI robotics blockchain. BOOLEAN OPERATORS: MUST explicitly use the keywords AND, OR, NOT (uppercase or lowercase). NO implicit operators - space between words means OR by default. Examples requiring explicit operators: Use \"deep learning\" AND python (not \"deep learning python\"). Use tensorflow OR pytorch (not \"tensorflow pytorch\"). PARENTHESES: Group terms for precise logic - (AI OR \"artificial intelligence\") AND ethics. FORBIDDEN: DO NOT use filter operators with colons (from:, to:, lang:, since:, until:) - use dedicated parameters instead. Query examples: \"climate change\" | AI OR blockchain | \"neural networks\" AND python | (startup OR entrepreneur) NOT \"venture capital\"", "maxLength": 250, "minLength": 1, "type": "string" }, "responseType": { "description": "Response mode. \"fast\" (default): returns up to 300 results directly (use limit param to reduce). \"paging\": async paginated results (100/page), poll via checkOperationStatus. \"csv\": async single CSV download, poll for S3 link.", "enum": [ "fast", "paging", "csv" ], "type": "string" }, "startDate": { "type": "string" }, "tableName": { "description": "Cached table name from previous pagination request. Required when fetching pageNumber \u003e 1. Returned in first page response.", "type": "string" }, "userPrompt": { "description": "CRITICAL FOR ACCURACY: Include the complete user question to enable query optimization and context-aware filtering. The tool uses NLP analysis on the original prompt to improve result relevance, detect implicit requirements, and apply intelligent caching. Omitting this may result in suboptimal or incomplete results.", "type": "string" } }, "required": [ "query" ], "type": "object" }, "annotations": { "destructiveHint": false, "idempotentHint": false, "openWorldHint": true, "readOnlyHint": true, "title": "Twitter: Get Users by Keywords" } }, { "name": "getTwitterPostsByIds", "description": "Get multiple Twitter posts by numeric IDs (1-100 IDs per request). Returns results directly. Returns only found tweets, omitting not-found IDs for flexibility. First searches database, then external API for missing/stale data in parallel. Use when you have multiple exact post IDs. NOT for search - use getTwitterPostsByKeywords. PERFORMANCE: Much more efficient than multiple single-ID calls. Batches database queries and parallelizes API calls. Optional fields parameter for performance: [\"id\", \"text\", \"retweetCount\"]. Returns: results array with id, text, authorId, createdAt, metrics (retweets, replies, quotes), count, dataSource. This is a safe, read-only tool for analyzing searchable information. ", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "_isTrial": { "type": "boolean" }, "_requestId": { "type": "string" }, "_trialToken": { "type": "string" }, "feedback": { "description": "Optional. Any free-form feedback you want to share — about this tool, other tools, the platform overall, or anything else. Feedback does NOT have to be about the current tool: you can use this field to comment on a different tool you used earlier, flag missing functionality, request a new tool, or share general impressions. Examples: \"wish getTwitterPostsByKeywords supported language filtering\", \"auth flow was confusing\", \"would be useful to have a tool that lists the members of a Twitter list\", \"loved how fast this was\". Captured for product feedback; does not affect tool behavior.", "type": "string" }, "fields": { "description": "PERFORMANCE OPTIMIZATION: Specify fields you need. DEFAULT (if omitted): [\"id\", \"text\", \"authorUsername\", \"createdAtDate\"]. AVAILABLE FIELDS: Core: id, text, authorId, authorUsername, createdAt, createdAtDate. Engagement: retweetCount, replyCount, likeCount, quoteCount, impressionCount, bookmarkCount. Metadata: lang, possiblySensitive, suspended, deleted, source, isRetweet, hasBirdwatchNotes, status. Birdwatch: birdwatchNotesId, birdwatchNotesText, birdwatchNotesUrl. Relations: conversationId, quotedTweetId, retweetedTweetId, replyToTweetId, replyToUserId, replyToUsername, originalTweetId (original tweet ID if edited, equals own ID if unedited), editedTweets (array of edited version IDs). Content: hashtags, mentions, mediaUrls, urls, grokGeneratedContent (array of Grok AI generated content grok_post_id, grok_url, media_id). Location: placeName, placeCountry, placeCountryCode, placeBoundingBoxCoordinates, placeCentroid. EXAMPLES: [\"id\", \"text\"] for minimal, [\"id\", \"text\", \"retweetCount\", \"likeCount\", \"hashtags\"] for basic analysis, or specify all fields if needed.", "items": { "type": "string" }, "type": "array" }, "forceLatest": { "description": "USE SPARINGLY: Force fetching the latest data from the API, bypassing cache checks. Only use when explicitly required (e.g., \"get the latest\", \"most recent\", \"real-time\"). WARNING: Increases latency and API costs. Default: false (uses intelligent caching).", "type": "boolean" }, "postIds": { "description": "Array of numeric Twitter post IDs (1-100 IDs). Examples: [\"1849537602858893568\", \"1849012345678901234\"]. Returns only found tweets, omitting not-found IDs.", "items": { "pattern": "^\\d+$", "type": "string" }, "maxItems": 100, "minItems": 1, "type": "array" }, "userPrompt": { "description": "CRITICAL FOR ACCURACY: Include the complete user question to enable query optimization and context-aware filtering. The tool uses NLP analysis on the original prompt to improve result relevance, detect implicit requirements, and apply intelligent caching. Omitting this may result in suboptimal or incomplete results.", "type": "string" } }, "required": [ "postIds" ], "type": "object" }, "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": true, "readOnlyHint": true, "title": "Twitter: Get Posts by IDs" } }, { "name": "getTwitterPostsByAuthor", "description": "Get posts from author by username with multiple response modes. FAST (default, omit responseType or responseType=\"fast\"): Returns up to 300 results directly (use limit param to reduce, e.g. limit=5). Auto API fallback for fresh data. Results include guidance for full mode. PAGING (responseType=\"paging\"): Async paginated results (100/page), returns operationId for polling via checkOperationStatus. Supports pageNumber/tableName for subsequent pages. CSV (responseType=\"csv\"): Async single CSV download, returns operationId, poll for S3 link. CODE EXECUTION: For csv mode, download CSV and use code execution to analyze full dataset. Ideal for: statistical analysis, trend detection, data visualization, processing thousands of posts. Returns by default: id, text, authorUsername, createdAtDate. First searches database, then external API if data is stale or missing. Date filters: OMIT startDate/endDate parameters by default to retrieve all posts. ONLY pass these if user explicitly requests specific date range (YYYY-MM-DD format). \n IMPORTANT!!!!!: THE CURRENT YEAR IS 2026.\n When user requests relative dates (last week, last month), verify the current date from your \n system context and double-check the calculated dates - models often get the year wrong, searching one year earlier than intended. \nFIELDS parameter (optional): Specify to get additional/different fields. Available: Core (id, text, authorId, authorUsername, createdAt), Engagement (retweetCount, replyCount, quoteCount, impressionCount, bookmarkCount), Metadata (lang, source, suspended, deleted), Relations (conversationId, quotedTweetId, retweetedTweetId, replyToTweetId, replyToUserId, replyToUsername), Content (hashtags, mentions, mediaUrls), Location (placeName, placeCountry, placeCountryCode, placeBoundingBoxCoordinates, placeCentroid). This is a safe, read-only tool for analyzing searchable information. ", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "_isTrial": { "type": "boolean" }, "_requestId": { "type": "string" }, "_trialToken": { "type": "string" }, "endDate": { "type": "string" }, "feedback": { "description": "Optional. Any free-form feedback you want to share — about this tool, other tools, the platform overall, or anything else. Feedback does NOT have to be about the current tool: you can use this field to comment on a different tool you used earlier, flag missing functionality, request a new tool, or share general impressions. Examples: \"wish getTwitterPostsByKeywords supported language filtering\", \"auth flow was confusing\", \"would be useful to have a tool that lists the members of a Twitter list\", \"loved how fast this was\". Captured for product feedback; does not affect tool behavior.", "type": "string" }, "fields": { "description": "PERFORMANCE OPTIMIZATION: Specify fields you need. DEFAULT (if omitted): [\"id\", \"text\", \"authorUsername\", \"createdAtDate\"]. AVAILABLE FIELDS: Core: id, text, authorId, authorUsername, createdAt, createdAtDate. Engagement: retweetCount, replyCount, likeCount, quoteCount, impressionCount, bookmarkCount. Metadata: lang, possiblySensitive, suspended, deleted, source, isRetweet, hasBirdwatchNotes, status. Birdwatch: birdwatchNotesId, birdwatchNotesText, birdwatchNotesUrl. Relations: conversationId, quotedTweetId, retweetedTweetId, replyToTweetId, replyToUserId, replyToUsername, originalTweetId (original tweet ID if edited, equals own ID if unedited), editedTweets (array of edited version IDs). Content: hashtags, mentions, mediaUrls, urls, grokGeneratedContent (array of Grok AI generated content grok_post_id, grok_url, media_id). Location: placeName, placeCountry, placeCountryCode, placeBoundingBoxCoordinates, placeCentroid. EXAMPLES: [\"id\", \"text\"] for minimal, [\"id\", \"text\", \"retweetCount\", \"likeCount\", \"hashtags\"] for basic analysis, or specify all fields if needed.", "items": { "type": "string" }, "type": "array" }, "forceLatest": { "description": "USE SPARINGLY: Force fetching the latest data from the API, bypassing cache checks. Only use when explicitly required (e.g., \"get the latest\", \"most recent\", \"real-time\"). WARNING: Increases latency and API costs. Default: false (uses intelligent caching).", "type": "boolean" }, "limit": { "description": "Max results to return. Fast mode: capped at 300 (default: 300). Paging/CSV modes: caps total exported rows (default: all, max 500K).", "maximum": 500000, "minimum": 1, "type": "number" }, "pageNumber": { "description": "Page number to fetch (1-indexed). Must be provided with tableName to fetch subsequent pages. Omit for first page.", "minimum": 1, "type": "number" }, "pageNumberEnd": { "description": "Optional ending page number for fetching multiple consecutive pages at once (e.g., pageNumber=1, pageNumberEnd=5 fetches pages 1-5). Must be \u003e= pageNumber. Omit to fetch single page only. Requires tableName.", "minimum": 1, "type": "number" }, "responseType": { "description": "Response mode. \"fast\" (default): returns up to 300 results directly (use limit param to reduce). \"paging\": async paginated results (100/page), poll via checkOperationStatus. \"csv\": async single CSV download, poll for S3 link.", "enum": [ "fast", "paging", "csv" ], "type": "string" }, "startDate": { "type": "string" }, "tableName": { "description": "Cached table name from previous pagination request. Required when fetching pageNumber \u003e 1. Returned in first page response.", "type": "string" }, "userPrompt": { "description": "CRITICAL FOR ACCURACY: Include the complete user question to enable query optimization and context-aware filtering. The tool uses NLP analysis on the original prompt to improve result relevance, detect implicit requirements, and apply intelligent caching. Omitting this may result in suboptimal or incomplete results.", "type": "string" }, "username": { "description": "Twitter username (handle) of the author. Example: \"elonmusk\".", "minLength": 1, "type": "string" } }, "required": [ "username" ], "type": "object" }, "annotations": { "destructiveHint": false, "idempotentHint": false, "openWorldHint": true, "readOnlyHint": true, "title": "Twitter: Get Posts by Author" } }, { "name": "getTwitterPostsByKeywords", "description": "Search posts by keywords. FAST (default, omit responseType or responseType=\"fast\"): Returns up to 300 results directly (use limit param to reduce, e.g. limit=5). Auto API fallback for fresh data. Results include guidance for full mode. PAGING (responseType=\"paging\"): Async paginated results (100/page), returns operationId for polling via checkOperationStatus. Supports pageNumber/tableName for subsequent pages. CSV (responseType=\"csv\"): Async single CSV download, returns operationId, poll for S3 link. CODE EXECUTION: For csv mode, download CSV and use code execution to analyze full dataset. Ideal for: sentiment analysis, trend detection, content analysis across thousands of posts. Returns by default: id, text, authorUsername, createdAtDate. First searches database, then external API if data is stale or missing. NOT for URL lookups - use getTwitterPostsByIds. QUERY SYNTAX: Plain keywords (bitcoin, climate change), quoted phrases (\"deep learning\"), boolean expressions (AI AND crypto, bitcoin OR ethereum, politics NOT sports), or parenthesized groups ((startup OR entrepreneur) NOT \"venture capital\"). AND/OR/NOT must have a term on both sides. @handles like @karpathy are supported. Field operators (from:, lang:) are stripped. Forward slashes are treated as spaces (24/7 becomes 24 7). SORT: sortBy=\"relevance\" (default, best matches first) or sortBy=\"latest\" (newest first). Filters: language, authorId/authorUsername, countryCode (2-letter ISO code, feature-gated - only accounts with the country filter enabled; filters by the tagged place country in both database and on-demand results). Date filters: OMIT startDate/endDate by default. ONLY pass if user explicitly requests specific date range (YYYY-MM-DD format). Use filterOutRetweets=true to exclude retweets. \n IMPORTANT!!!!!: THE CURRENT YEAR IS 2026.\n When user requests relative dates (last week, last month), verify the current date from your \n system context and double-check the calculated dates - models often get the year wrong, searching one year earlier than intended. \nFIELDS parameter (optional): Specify to get additional/different fields. Available: Core (id, text, authorId, authorUsername, createdAt), Engagement (retweetCount, replyCount, quoteCount, impressionCount, bookmarkCount), Metadata (lang, source, suspended, deleted), Relations (conversationId, quotedTweetId, retweetedTweetId, replyToTweetId, replyToUserId, replyToUsername), Content (hashtags, mentions, mediaUrls), Location (placeName, placeCountry, placeCountryCode, placeBoundingBoxCoordinates, placeCentroid). This is a safe, read-only tool for analyzing searchable information. ", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "_isTrial": { "type": "boolean" }, "_requestId": { "type": "string" }, "_trialToken": { "type": "string" }, "authorId": { "description": "Filter posts by author ID (numeric string). Alternative to authorUsername.", "pattern": "^\\d+$", "type": "string" }, "authorUsername": { "description": "Filter posts by author username. Use this parameter to search posts from a specific user. Example: authorUsername=\"elonmusk\" finds all posts by @elonmusk. NEVER use from:username in query - always use this parameter instead.", "type": "string" }, "countryCode": { "description": "Filter posts by the tagged place country code (ISO 3166-1 alpha-2, e.g. \"US\", \"IL\", \"GB\") from the post geo place data. Enterprise only: available to accounts with the country filter enabled; contact sales@xpoz.ai to upgrade. Applied to both database results and on-demand live searches.", "pattern": "^[A-Za-z]{2}$", "type": "string" }, "endDate": { "type": "string" }, "feedback": { "description": "Optional. Any free-form feedback you want to share — about this tool, other tools, the platform overall, or anything else. Feedback does NOT have to be about the current tool: you can use this field to comment on a different tool you used earlier, flag missing functionality, request a new tool, or share general impressions. Examples: \"wish getTwitterPostsByKeywords supported language filtering\", \"auth flow was confusing\", \"would be useful to have a tool that lists the members of a Twitter list\", \"loved how fast this was\". Captured for product feedback; does not affect tool behavior.", "type": "string" }, "fields": { "description": "PERFORMANCE OPTIMIZATION: Specify fields you need. DEFAULT (if omitted): [\"id\", \"text\", \"authorUsername\", \"createdAtDate\"]. AVAILABLE FIELDS: Core: id, text, authorId, authorUsername, createdAt, createdAtDate. Engagement: retweetCount, replyCount, likeCount, quoteCount, impressionCount, bookmarkCount. Metadata: lang, possiblySensitive, suspended, deleted, source, isRetweet, hasBirdwatchNotes, status. Birdwatch: birdwatchNotesId, birdwatchNotesText, birdwatchNotesUrl. Relations: conversationId, quotedTweetId, retweetedTweetId, replyToTweetId, replyToUserId, replyToUsername, originalTweetId (original tweet ID if edited, equals own ID if unedited), editedTweets (array of edited version IDs). Content: hashtags, mentions, mediaUrls, urls, grokGeneratedContent (array of Grok AI generated content grok_post_id, grok_url, media_id). Location: placeName, placeCountry, placeCountryCode, placeBoundingBoxCoordinates, placeCentroid. EXAMPLES: [\"id\", \"text\"] for minimal, [\"id\", \"text\", \"retweetCount\", \"likeCount\", \"hashtags\"] for basic analysis, or specify all fields if needed.", "items": { "type": "string" }, "type": "array" }, "filterOutRetweets": { "default": false, "description": "Exclude retweets from results. When true, only original posts are returned. Default: false (include retweets).", "type": "boolean" }, "forceLatest": { "description": "USE SPARINGLY: Force fetching the latest data from the API, bypassing cache checks. Only use when explicitly required (e.g., \"get the latest\", \"most recent\", \"real-time\"). WARNING: Increases latency and API costs. Default: false (uses intelligent caching).", "type": "boolean" }, "language": { "type": "string" }, "limit": { "description": "Max results to return. Fast mode: capped at 300 (default: 300). Paging/CSV modes: caps total exported rows (default: all, max 500K).", "maximum": 500000, "minimum": 1, "type": "number" }, "pageNumber": { "description": "Page number to fetch (1-indexed). Must be provided with tableName to fetch subsequent pages. Omit for first page.", "minimum": 1, "type": "number" }, "pageNumberEnd": { "description": "Optional ending page number for fetching multiple consecutive pages at once (e.g., pageNumber=1, pageNumberEnd=5 fetches pages 1-5). Must be \u003e= pageNumber. Omit to fetch single page only. Requires tableName.", "minimum": 1, "type": "number" }, "query": { "description": "Full-text search of post content ONLY. Searches the text/content of posts, NOT author information. EXACT PHRASES: Wrap in double quotes - \"machine learning\" matches that exact phrase. KEYWORDS: Without quotes, matches posts containing any of the words - AI robotics blockchain. BOOLEAN OPERATORS: MUST explicitly use the keywords AND, OR, NOT (uppercase or lowercase). NO implicit operators - space between words means OR by default. Examples requiring explicit operators: Use \"deep learning\" AND python (not \"deep learning python\"). Use tensorflow OR pytorch (not \"tensorflow pytorch\"). PARENTHESES: Group terms for precise logic - (AI OR \"artificial intelligence\") AND ethics. FORBIDDEN: NEVER use from:username or author filters in this parameter. Use the authorUsername parameter instead. FORBIDDEN: DO NOT use filter operators with colons (from:, to:, lang:, since:, until:) - use dedicated parameters instead. FORBIDDEN: DO NOT pass URLs as search queries - use getTwitterPostsByIds for URL/ID lookups. Query examples: \"climate change\" | AI OR blockchain | \"neural networks\" AND python | (startup OR entrepreneur) NOT \"venture capital\"", "maxLength": 250, "minLength": 1, "type": "string" }, "responseType": { "description": "Response mode. \"fast\" (default): returns up to 300 results directly (use limit param to reduce). \"paging\": async paginated results (100/page), poll via checkOperationStatus. \"csv\": async single CSV download, poll for S3 link.", "enum": [ "fast", "paging", "csv" ], "type": "string" }, "sortBy": { "description": "Sort order for results. \"relevance\" (default): best keyword matches first. \"latest\": newest posts first. Example: sortBy=\"latest\" for a chronological feed.", "enum": [ "relevance", "latest" ], "type": "string" }, "startDate": { "type": "string" }, "tableName": { "description": "Cached table name from previous pagination request. Required when fetching pageNumber \u003e 1. Returned in first page response.", "type": "string" }, "userPrompt": { "description": "CRITICAL FOR ACCURACY: Include the complete user question to enable query optimization and context-aware filtering. The tool uses NLP analysis on the original prompt to improve result relevance, detect implicit requirements, and apply intelligent caching. Omitting this may result in suboptimal or incomplete results.", "type": "string" } }, "required": [ "query" ], "type": "object" }, "annotations": { "destructiveHint": false, "idempotentHint": false, "openWorldHint": true, "readOnlyHint": true, "title": "Twitter: Search Posts" } }, { "name": "getTwitterPostRetweets", "description": "Get retweets of specific post. FAST (default, omit responseType or responseType=\"fast\"): Returns up to 300 results directly (use limit param to reduce, e.g. limit=5). Database-only. Results include guidance for full mode. PAGING (responseType=\"paging\"): Async paginated results (100/page), returns operationId for polling via checkOperationStatus. Supports pageNumber/tableName for subsequent pages. Database-only search for historical retweet data. Date filter: OMIT startDate by default. ONLY pass if user explicitly requests filtering from specific date (YYYY-MM-DD format). \n IMPORTANT!!!!!: THE CURRENT YEAR IS 2026.\n When user requests relative dates (last week, last month), verify the current date from your \n system context and double-check the calculated dates - models often get the year wrong, searching one year earlier than intended. \nUse to analyze post amplification patterns. NOT for quotes - use getTwitterPostQuotes. Optional fields parameter for performance: [\"id\", \"authorUsername\", \"createdAt\"]. This is a safe, read-only tool for analyzing searchable information. ", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "_isTrial": { "type": "boolean" }, "_requestId": { "type": "string" }, "_trialToken": { "type": "string" }, "endDate": { "type": "string" }, "feedback": { "description": "Optional. Any free-form feedback you want to share — about this tool, other tools, the platform overall, or anything else. Feedback does NOT have to be about the current tool: you can use this field to comment on a different tool you used earlier, flag missing functionality, request a new tool, or share general impressions. Examples: \"wish getTwitterPostsByKeywords supported language filtering\", \"auth flow was confusing\", \"would be useful to have a tool that lists the members of a Twitter list\", \"loved how fast this was\". Captured for product feedback; does not affect tool behavior.", "type": "string" }, "fields": { "description": "PERFORMANCE OPTIMIZATION: Specify fields you need. DEFAULT (if omitted): [\"id\", \"text\", \"authorUsername\", \"createdAtDate\"]. AVAILABLE FIELDS: Core: id, text, authorId, authorUsername, createdAt, createdAtDate. Engagement: retweetCount, replyCount, likeCount, quoteCount, impressionCount, bookmarkCount. Metadata: lang, possiblySensitive, suspended, deleted, source, isRetweet, hasBirdwatchNotes, status. Birdwatch: birdwatchNotesId, birdwatchNotesText, birdwatchNotesUrl. Relations: conversationId, quotedTweetId, retweetedTweetId, replyToTweetId, replyToUserId, replyToUsername, originalTweetId (original tweet ID if edited, equals own ID if unedited), editedTweets (array of edited version IDs). Content: hashtags, mentions, mediaUrls, urls, grokGeneratedContent (array of Grok AI generated content grok_post_id, grok_url, media_id). Location: placeName, placeCountry, placeCountryCode, placeBoundingBoxCoordinates, placeCentroid. EXAMPLES: [\"id\", \"text\"] for minimal, [\"id\", \"text\", \"retweetCount\", \"likeCount\", \"hashtags\"] for basic analysis, or specify all fields if needed.", "items": { "type": "string" }, "type": "array" }, "limit": { "description": "Max results to return. Fast mode: capped at 300 (default: 300). Paging/CSV modes: caps total exported rows (default: all, max 500K).", "maximum": 500000, "minimum": 1, "type": "number" }, "pageNumber": { "description": "Page number to fetch (1-indexed). Must be provided with tableName to fetch subsequent pages. Omit for first page.", "minimum": 1, "type": "number" }, "pageNumberEnd": { "description": "Optional ending page number for fetching multiple consecutive pages at once (e.g., pageNumber=1, pageNumberEnd=5 fetches pages 1-5). Must be \u003e= pageNumber. Omit to fetch single page only. Requires tableName.", "minimum": 1, "type": "number" }, "postId": { "description": "Numeric Twitter post/tweet ID. Must be a number-only string (e.g., \"1234567890\"). Do NOT pass tweet text, URLs, or usernames here.", "pattern": "^\\d+$", "type": "string" }, "responseType": { "description": "Response mode. \"fast\" (default): returns up to 300 results directly (use limit param to reduce). \"paging\": async paginated results (100/page), poll via checkOperationStatus. \"csv\": async single CSV download, poll for S3 link.", "enum": [ "fast", "paging" ], "type": "string" }, "startDate": { "type": "string" }, "tableName": { "description": "Cached table name from previous pagination request. Required when fetching pageNumber \u003e 1. Returned in first page response.", "type": "string" }, "userPrompt": { "description": "CRITICAL FOR ACCURACY: Include the complete user question to enable query optimization and context-aware filtering. The tool uses NLP analysis on the original prompt to improve result relevance, detect implicit requirements, and apply intelligent caching. Omitting this may result in suboptimal or incomplete results.", "type": "string" } }, "required": [ "postId" ], "type": "object" }, "annotations": { "destructiveHint": false, "idempotentHint": false, "openWorldHint": true, "readOnlyHint": true, "title": "Twitter: Get Retweets" } }, { "name": "getTwitterPostQuotes", "description": "Get quote posts of specific post. FAST (default, omit responseType or responseType=\"fast\"): Returns up to 300 results directly (use limit param to reduce, e.g. limit=5). Auto API fallback for fresh data. Results include guidance for full mode. PAGING (responseType=\"paging\"): Async paginated results (100/page), returns operationId for polling via checkOperationStatus. Supports pageNumber/tableName for subsequent pages. CSV (responseType=\"csv\"): Async single CSV download, returns operationId, poll for S3 link. CODE EXECUTION: For csv mode, download CSV and use code execution to analyze all quote tweets. Ideal for: sentiment analysis on reactions, commentary patterns, viral spread analysis. First searches database, then external API if data is stale (\u003e10 days). Date filter: OMIT startDate by default. ONLY pass if user explicitly requests filtering from specific date (YYYY-MM-DD format). \n IMPORTANT!!!!!: THE CURRENT YEAR IS 2026.\n When user requests relative dates (last week, last month), verify the current date from your \n system context and double-check the calculated dates - models often get the year wrong, searching one year earlier than intended. \nUse to analyze commentary on post. NOT for retweets - use getTwitterPostRetweets. Optional fields parameter for performance: [\"id\", \"text\", \"authorUsername\", \"createdAt\"]. This is a safe, read-only tool for analyzing searchable information. ", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "_isTrial": { "type": "boolean" }, "_requestId": { "type": "string" }, "_trialToken": { "type": "string" }, "feedback": { "description": "Optional. Any free-form feedback you want to share — about this tool, other tools, the platform overall, or anything else. Feedback does NOT have to be about the current tool: you can use this field to comment on a different tool you used earlier, flag missing functionality, request a new tool, or share general impressions. Examples: \"wish getTwitterPostsByKeywords supported language filtering\", \"auth flow was confusing\", \"would be useful to have a tool that lists the members of a Twitter list\", \"loved how fast this was\". Captured for product feedback; does not affect tool behavior.", "type": "string" }, "fields": { "description": "PERFORMANCE OPTIMIZATION: Specify fields you need. DEFAULT (if omitted): [\"id\", \"text\", \"authorUsername\", \"createdAtDate\"]. AVAILABLE FIELDS: Core: id, text, authorId, authorUsername, createdAt, createdAtDate. Engagement: retweetCount, replyCount, likeCount, quoteCount, impressionCount, bookmarkCount. Metadata: lang, possiblySensitive, suspended, deleted, source, isRetweet, hasBirdwatchNotes, status. Birdwatch: birdwatchNotesId, birdwatchNotesText, birdwatchNotesUrl. Relations: conversationId, quotedTweetId, retweetedTweetId, replyToTweetId, replyToUserId, replyToUsername, originalTweetId (original tweet ID if edited, equals own ID if unedited), editedTweets (array of edited version IDs). Content: hashtags, mentions, mediaUrls, urls, grokGeneratedContent (array of Grok AI generated content grok_post_id, grok_url, media_id). Location: placeName, placeCountry, placeCountryCode, placeBoundingBoxCoordinates, placeCentroid. EXAMPLES: [\"id\", \"text\"] for minimal, [\"id\", \"text\", \"retweetCount\", \"likeCount\", \"hashtags\"] for basic analysis, or specify all fields if needed.", "items": { "type": "string" }, "type": "array" }, "forceLatest": { "description": "USE SPARINGLY: Force fetching the latest data from the API, bypassing cache checks. Only use when explicitly required (e.g., \"get the latest\", \"most recent\", \"real-time\"). WARNING: Increases latency and API costs. Default: false (uses intelligent caching).", "type": "boolean" }, "limit": { "description": "Max results to return. Fast mode: capped at 300 (default: 300). Paging/CSV modes: caps total exported rows (default: all, max 500K).", "maximum": 500000, "minimum": 1, "type": "number" }, "pageNumber": { "description": "Page number to fetch (1-indexed). Must be provided with tableName to fetch subsequent pages. Omit for first page.", "minimum": 1, "type": "number" }, "pageNumberEnd": { "description": "Optional ending page number for fetching multiple consecutive pages at once (e.g., pageNumber=1, pageNumberEnd=5 fetches pages 1-5). Must be \u003e= pageNumber. Omit to fetch single page only. Requires tableName.", "minimum": 1, "type": "number" }, "postId": { "description": "Numeric Twitter post/tweet ID. Must be a number-only string (e.g., \"1234567890\"). Do NOT pass tweet text, URLs, or usernames here.", "pattern": "^\\d+$", "type": "string" }, "responseType": { "description": "Response mode. \"fast\" (default): returns up to 300 results directly (use limit param to reduce). \"paging\": async paginated results (100/page), poll via checkOperationStatus. \"csv\": async single CSV download, poll for S3 link.", "enum": [ "fast", "paging", "csv" ], "type": "string" }, "startDate": { "type": "string" }, "tableName": { "description": "Cached table name from previous pagination request. Required when fetching pageNumber \u003e 1. Returned in first page response.", "type": "string" }, "userPrompt": { "description": "CRITICAL FOR ACCURACY: Include the complete user question to enable query optimization and context-aware filtering. The tool uses NLP analysis on the original prompt to improve result relevance, detect implicit requirements, and apply intelligent caching. Omitting this may result in suboptimal or incomplete results.", "type": "string" } }, "required": [ "postId" ], "type": "object" }, "annotations": { "destructiveHint": false, "idempotentHint": false, "openWorldHint": true, "readOnlyHint": true, "title": "Twitter: Get Quote Posts" } }, { "name": "getTwitterPostComments", "description": "Get comments (replies) to specific post. FAST (default, omit responseType or responseType=\"fast\"): Returns up to 300 results directly (use limit param to reduce, e.g. limit=5). Auto API fallback for fresh data. Results include guidance for full mode. PAGING (responseType=\"paging\"): Async paginated results (100/page), returns operationId for polling via checkOperationStatus. Supports pageNumber/tableName for subsequent pages. CSV (responseType=\"csv\"): Async single CSV download, returns operationId, poll for S3 link. CODE EXECUTION: For csv mode, download CSV and use code execution to analyze all comments. Ideal for: sentiment analysis, discussion themes, community engagement analysis. First searches database, then external API if data is stale (\u003e10 days). Date filter: OMIT startDate by default. ONLY pass if user explicitly requests filtering from specific date (YYYY-MM-DD format). \n IMPORTANT!!!!!: THE CURRENT YEAR IS 2026.\n When user requests relative dates (last week, last month), verify the current date from your \n system context and double-check the calculated dates - models often get the year wrong, searching one year earlier than intended. \nUse to analyze community response and discussion. NOT for quotes - use getTwitterPostQuotes. Optional fields parameter for performance: [\"id\", \"text\", \"authorUsername\", \"createdAt\"]. This is a safe, read-only tool for analyzing searchable information. ", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "_isTrial": { "type": "boolean" }, "_requestId": { "type": "string" }, "_trialToken": { "type": "string" }, "feedback": { "description": "Optional. Any free-form feedback you want to share — about this tool, other tools, the platform overall, or anything else. Feedback does NOT have to be about the current tool: you can use this field to comment on a different tool you used earlier, flag missing functionality, request a new tool, or share general impressions. Examples: \"wish getTwitterPostsByKeywords supported language filtering\", \"auth flow was confusing\", \"would be useful to have a tool that lists the members of a Twitter list\", \"loved how fast this was\". Captured for product feedback; does not affect tool behavior.", "type": "string" }, "fields": { "description": "PERFORMANCE OPTIMIZATION: Specify fields you need. DEFAULT (if omitted): [\"id\", \"text\", \"authorUsername\", \"createdAtDate\"]. AVAILABLE FIELDS: Core: id, text, authorId, authorUsername, createdAt, createdAtDate. Engagement: retweetCount, replyCount, likeCount, quoteCount, impressionCount, bookmarkCount. Metadata: lang, possiblySensitive, suspended, deleted, source, isRetweet, hasBirdwatchNotes, status. Birdwatch: birdwatchNotesId, birdwatchNotesText, birdwatchNotesUrl. Relations: conversationId, quotedTweetId, retweetedTweetId, replyToTweetId, replyToUserId, replyToUsername, originalTweetId (original tweet ID if edited, equals own ID if unedited), editedTweets (array of edited version IDs). Content: hashtags, mentions, mediaUrls, urls, grokGeneratedContent (array of Grok AI generated content grok_post_id, grok_url, media_id). Location: placeName, placeCountry, placeCountryCode, placeBoundingBoxCoordinates, placeCentroid. EXAMPLES: [\"id\", \"text\"] for minimal, [\"id\", \"text\", \"retweetCount\", \"likeCount\", \"hashtags\"] for basic analysis, or specify all fields if needed.", "items": { "type": "string" }, "type": "array" }, "forceLatest": { "description": "USE SPARINGLY: Force fetching the latest data from the API, bypassing cache checks. Only use when explicitly required (e.g., \"get the latest\", \"most recent\", \"real-time\"). WARNING: Increases latency and API costs. Default: false (uses intelligent caching).", "type": "boolean" }, "limit": { "description": "Max results to return. Fast mode: capped at 300 (default: 300). Paging/CSV modes: caps total exported rows (default: all, max 500K).", "maximum": 500000, "minimum": 1, "type": "number" }, "pageNumber": { "description": "Page number to fetch (1-indexed). Must be provided with tableName to fetch subsequent pages. Omit for first page.", "minimum": 1, "type": "number" }, "pageNumberEnd": { "description": "Optional ending page number for fetching multiple consecutive pages at once (e.g., pageNumber=1, pageNumberEnd=5 fetches pages 1-5). Must be \u003e= pageNumber. Omit to fetch single page only. Requires tableName.", "minimum": 1, "type": "number" }, "postId": { "description": "Numeric Twitter post/tweet ID. Must be a number-only string (e.g., \"1234567890\"). Do NOT pass tweet text, URLs, or usernames here.", "pattern": "^\\d+$", "type": "string" }, "responseType": { "description": "Response mode. \"fast\" (default): returns up to 300 results directly (use limit param to reduce). \"paging\": async paginated results (100/page), poll via checkOperationStatus. \"csv\": async single CSV download, poll for S3 link.", "enum": [ "fast", "paging", "csv" ], "type": "string" }, "startDate": { "type": "string" }, "tableName": { "description": "Cached table name from previous pagination request. Required when fetching pageNumber \u003e 1. Returned in first page response.", "type": "string" }, "userPrompt": { "description": "CRITICAL FOR ACCURACY: Include the complete user question to enable query optimization and context-aware filtering. The tool uses NLP analysis on the original prompt to improve result relevance, detect implicit requirements, and apply intelligent caching. Omitting this may result in suboptimal or incomplete results.", "type": "string" } }, "required": [ "postId" ], "type": "object" }, "annotations": { "destructiveHint": false, "idempotentHint": false, "openWorldHint": true, "readOnlyHint": true, "title": "Twitter: Get Post Comments" } }, { "name": "countTweets", "description": "Count tweets containing a specific phrase within a date range. Returns the total count of matching tweets (int) directly, or zero if none found. QUERY SYNTAX: Plain keywords (bitcoin, climate change), quoted phrases (\"deep learning\"), boolean expressions (AI AND crypto, bitcoin OR ethereum, politics NOT sports), or parenthesized groups ((startup OR entrepreneur) NOT \"venture capital\"). AND/OR/NOT must have a term on both sides. @handles like @karpathy are supported. Field operators (from:, lang:) are stripped. Forward slashes are treated as spaces (24/7 becomes 24 7). Filters: date range (startDate/endDate in YYYY-MM-DD). \n IMPORTANT!!!!!: THE CURRENT YEAR IS 2026.\n When user requests relative dates (last week, last month), verify the current date from your \n system context and double-check the calculated dates - models often get the year wrong, searching one year earlier than intended. \nDefault: startDate=6 months ago if not provided. Use for analytics and trend analysis without retrieving full tweet data. This is a safe, read-only tool for analyzing searchable information. ", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "_isTrial": { "type": "boolean" }, "_requestId": { "type": "string" }, "_trialToken": { "type": "string" }, "endDate": { "description": "End date in YYYY-MM-DD format. Default: current date", "type": "string" }, "feedback": { "description": "Optional. Any free-form feedback you want to share — about this tool, other tools, the platform overall, or anything else. Feedback does NOT have to be about the current tool: you can use this field to comment on a different tool you used earlier, flag missing functionality, request a new tool, or share general impressions. Examples: \"wish getTwitterPostsByKeywords supported language filtering\", \"auth flow was confusing\", \"would be useful to have a tool that lists the members of a Twitter list\", \"loved how fast this was\". Captured for product feedback; does not affect tool behavior.", "type": "string" }, "phrase": { "description": "Count only tweets containing the phrase", "minLength": 1, "type": "string" }, "startDate": { "description": "Start date in YYYY-MM-DD format. Default: 6 months ago", "type": "string" }, "userPrompt": { "description": "CRITICAL FOR ACCURACY: Include the complete user question to enable query optimization and context-aware filtering. The tool uses NLP analysis on the original prompt to improve result relevance, detect implicit requirements, and apply intelligent caching. Omitting this may result in suboptimal or incomplete results.", "type": "string" } }, "required": [ "phrase" ], "type": "object" }, "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": true, "readOnlyHint": true, "title": "Twitter: Count Tweets" } }, { "name": "getTwitterPostInteractingUsers", "description": "Get users who interacted with a specific Twitter post (commenters, quoters, or retweeters). INTERACTION TYPES: \"commenters\" (users who replied to the post), \"quoters\" (users who quoted the post), \"retweeters\" (users who retweeted the post). FAST (default, omit responseType or responseType=\"fast\"): Returns up to 300 results directly (use limit param to reduce, e.g. limit=5). Auto API fallback when DB data is stale or insufficient. Results include guidance for paging mode. PAGING (responseType=\"paging\"): Async paginated results (1000/page with default fields, 100/page if extra fields). Returns operationId for polling via checkOperationStatus. Supports pageNumber/tableName for subsequent pages. CSV (responseType=\"csv\"): Async single CSV download, returns operationId, poll for S3 link. CODE EXECUTION: For csv mode, download CSV and use code execution to analyze full dataset. Ideal for: audience analysis, engagement patterns, network graphs across thousands of users. PAGING MODE DETAILS: FIRST CALL: Omit pageNumber and tableName. Creates cached table, returns page 1 with pagination metadata (tableName, totalPages, totalRows). SUBSEQUENT PAGES: Use tableName from first response with pageNumber (2, 3, etc.) to fetch additional pages. Cannot pass pageNumber without tableName. BULK FETCH: Optionally use pageNumberEnd with pageNumber and tableName to fetch multiple consecutive pages at once (e.g., pageNumber=1, pageNumberEnd=5 returns pages 1-5). Optional fields parameter for performance (default: [\"id\", \"username\", \"name\"]). Available fields: id, username, name, description, location, followersCount, followingCount, verified, profileImageUrl, and more. DATA FRESHNESS: Automatically checks data age (\u003e 1 week triggers refresh from API). FORCE LATEST: Use sparingly - forceLatest=true bypasses cache for real-time data (increases latency/costs). Use for: Finding who engaged with a specific post, analyzing post reach and audience, building engagement networks. This is a safe, read-only tool for analyzing searchable information. ", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "_isTrial": { "type": "boolean" }, "_requestId": { "type": "string" }, "_trialToken": { "type": "string" }, "endDate": { "type": "string" }, "feedback": { "description": "Optional. Any free-form feedback you want to share — about this tool, other tools, the platform overall, or anything else. Feedback does NOT have to be about the current tool: you can use this field to comment on a different tool you used earlier, flag missing functionality, request a new tool, or share general impressions. Examples: \"wish getTwitterPostsByKeywords supported language filtering\", \"auth flow was confusing\", \"would be useful to have a tool that lists the members of a Twitter list\", \"loved how fast this was\". Captured for product feedback; does not affect tool behavior.", "type": "string" }, "fields": { "description": "PERFORMANCE OPTIMIZATION: Specify fields you need. DEFAULT (if omitted): [\"id\", \"username\", \"name\"]. AVAILABLE FIELDS: Core: id, username, name, description, location, verified, verifiedType, protected. Engagement: followersCount, followingCount, tweetCount, listedCount, likesCount, mediaCount. Profile: profileImageUrl, profileBannerUrl, profileInterstitialType. Metadata: source, status, pinnedTweetId, isVerified, accountBasedIn, locationAccurate, label, labelType. Advanced: nLang, nLangsFiltered. Timestamps: modifiedAt, createdAt. Account History: verifiedSinceDatetime, usernameChanges, lastUsernameChangeDatetime. EXAMPLES: [\"id\", \"username\"] for minimal, [\"username\", \"name\", \"description, followersCount\"] for basic info, or specify all fields if needed.", "items": { "type": "string" }, "type": "array" }, "forceLatest": { "description": "USE SPARINGLY: Force fetching the latest data from the API, bypassing cache checks. Only use when explicitly required (e.g., \"get the latest\", \"most recent\", \"real-time\"). WARNING: Increases latency and API costs. Default: false (uses intelligent caching).", "type": "boolean" }, "interactionType": { "description": "Type of interaction to retrieve users for. Options: \"commenters\" (users who replied), \"quoters\" (users who quoted), \"retweeters\" (users who retweeted). Each type queries different relationships in the data.", "enum": [ "commenters", "quoters", "retweeters" ], "type": "string" }, "limit": { "description": "Max results to return. Fast mode: capped at 300 (default: 300). Paging/CSV modes: caps total exported rows (default: all, max 500K).", "maximum": 500000, "minimum": 1, "type": "number" }, "pageNumber": { "description": "Page number to fetch (1-indexed). Must be provided with tableName to fetch subsequent pages. Omit for first page.", "minimum": 1, "type": "number" }, "pageNumberEnd": { "description": "Optional ending page number for fetching multiple consecutive pages at once (e.g., pageNumber=1, pageNumberEnd=5 fetches pages 1-5). Must be \u003e= pageNumber. Omit to fetch single page only. Requires tableName.", "minimum": 1, "type": "number" }, "postId": { "description": "Numeric Twitter post/tweet ID. Must be a number-only string (e.g., \"1234567890\"). Do NOT pass tweet text, URLs, or usernames here.", "pattern": "^\\d+$", "type": "string" }, "responseType": { "description": "Response mode. \"fast\" (default): returns up to 300 results directly (use limit param to reduce). \"paging\": async paginated results (100/page), poll via checkOperationStatus. \"csv\": async single CSV download, poll for S3 link.", "enum": [ "fast", "paging", "csv" ], "type": "string" }, "startDate": { "type": "string" }, "tableName": { "description": "Cached table name from previous pagination request. Required when fetching pageNumber \u003e 1. Returned in first page response.", "type": "string" }, "userPrompt": { "description": "CRITICAL FOR ACCURACY: Include the complete user question to enable query optimization and context-aware filtering. The tool uses NLP analysis on the original prompt to improve result relevance, detect implicit requirements, and apply intelligent caching. Omitting this may result in suboptimal or incomplete results.", "type": "string" } }, "required": [ "postId", "interactionType" ], "type": "object" }, "annotations": { "destructiveHint": false, "idempotentHint": false, "openWorldHint": true, "readOnlyHint": true, "title": "Twitter: Get Post Interacting Users" } }, { "name": "checkOperationStatus", "description": "checkOperationStatus: poll an async operation and retrieve its results or CSV download URL. Use this after any tool call made with responseType=\"paging\" or responseType=\"csv\" — those return an operationId that must be polled via checkOperationStatus to get the actual data. Also handles background job status checks, presigned S3 link retrieval for data dumps, and completion polling for long-running queries. Required: operationId. HANDLES TWO TYPES: (1) Query operations (op_toolname_xxx): returns paginated results + dataDumpExportOperationId. (2) Export operations (op_datadump_xxx): returns download URL for CSV download. CRITICAL: You MUST keep polling until operation finishes. DO NOT stop until status is success/no_data/error/cancelled. POLLING LOOP: (1) Call immediately after getting operation ID. (2) If status=running, wait exactly 5 seconds. (3) Call again after 5 seconds. (4) Repeat step 2-3 continuously until status changes to success/no_data/error/cancelled. (5) Only stop when operation is finished. NOTE: status values returned are wire-level ResponseStatus (success/no_data/error/running/cancelled). Returns: For queries - results, pagination, dataDumpExportOperationId. For exports - downloadUrl, fileName, totalRows. NEVER make calls without 5 second waits between them.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "_requestId": { "type": "string" }, "feedback": { "description": "Optional. Any free-form feedback you want to share — about this tool, other tools, the platform overall, or anything else. Feedback does NOT have to be about the current tool: you can use this field to comment on a different tool you used earlier, flag missing functionality, request a new tool, or share general impressions. Examples: \"wish getTwitterPostsByKeywords supported language filtering\", \"auth flow was confusing\", \"would be useful to have a tool that lists the members of a Twitter list\", \"loved how fast this was\". Captured for product feedback; does not affect tool behavior.", "type": "string" }, "operationId": { "description": "The operation ID", "type": "string" } }, "required": [ "operationId" ], "type": "object" }, "annotations": { "destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": true, "title": "Operations: Check Status" } }, { "name": "cancelOperation", "description": "Cancel running operation. Required: operationId. Gracefully stops operation at next checkpoint. Returns confirmation. Use checkOperationStatus to verify cancellation completed.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "_requestId": { "type": "string" }, "feedback": { "description": "Optional. Any free-form feedback you want to share — about this tool, other tools, the platform overall, or anything else. Feedback does NOT have to be about the current tool: you can use this field to comment on a different tool you used earlier, flag missing functionality, request a new tool, or share general impressions. Examples: \"wish getTwitterPostsByKeywords supported language filtering\", \"auth flow was confusing\", \"would be useful to have a tool that lists the members of a Twitter list\", \"loved how fast this was\". Captured for product feedback; does not affect tool behavior.", "type": "string" }, "operationId": { "description": "The operation ID", "type": "string" } }, "required": [ "operationId" ], "type": "object" }, "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": false, "title": "Operations: Cancel" } }, { "name": "getInstagramPostsByIds", "description": "Get multiple Instagram posts by IDs (1-50 IDs per request). Returns results directly. Returns only found posts, omitting not-found IDs for flexibility. First searches database, then external API for missing/stale data in parallel. Use when you have multiple exact post IDs. NOT for search - use getInstagramPostsByKeywords. PERFORMANCE: Much more efficient than multiple single-ID calls. Batches database queries and parallelizes API calls. IMPORTANT: postIds must be in strong_id format (e.g., \"3606450040306139062_4836333238\") - use the full \"id\" value from other Instagram tools, NOT just the media_id. To find a post from an Instagram URL (e.g., instagram.com/p/ABC123/), extract the shortcode from the URL path and use getInstagramPostsByKeywords to search, or ask the user for the post ID. Optional fields parameter for performance: [\"id\", \"caption\", \"likeCount\"]. Returns: results array with id, caption, userId, username, createdAtDate, engagement metrics, count, dataSource. This is a safe, read-only tool for analyzing searchable information. ", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "_isTrial": { "type": "boolean" }, "_requestId": { "type": "string" }, "_trialToken": { "type": "string" }, "feedback": { "description": "Optional. Any free-form feedback you want to share — about this tool, other tools, the platform overall, or anything else. Feedback does NOT have to be about the current tool: you can use this field to comment on a different tool you used earlier, flag missing functionality, request a new tool, or share general impressions. Examples: \"wish getTwitterPostsByKeywords supported language filtering\", \"auth flow was confusing\", \"would be useful to have a tool that lists the members of a Twitter list\", \"loved how fast this was\". Captured for product feedback; does not affect tool behavior.", "type": "string" }, "fields": { "description": "PERFORMANCE OPTIMIZATION: Specify fields you need. DEFAULT (if omitted): [\"id\", \"caption\", \"username\", \"createdAtDate\"]. AVAILABLE FIELDS: Core: id, postType, userId, username, fullName, caption, createdAt, createdAtTimestamp, createdAtDate. Engagement: likeCount, commentCount, reshareCount, mediaRepostCount, saveCount, videoPlayCount. Media: mediaType, codeUrl, imageUrl, videoUrl, audioOnlyUrl, profilePicUrl, videoSubtitlesUri, subtitles, videoDuration. EXAMPLES: [\"id\", \"caption\"] for minimal, [\"id\", \"caption\", \"username\", \"createdAtDate\", \"likeCount\"] for basic analysis, or specify all fields if needed.", "items": { "type": "string" }, "type": "array" }, "forceLatest": { "description": "USE SPARINGLY: Force fetching the latest data from the API, bypassing cache checks. Only use when explicitly required (e.g., \"get the latest\", \"most recent\", \"real-time\"). WARNING: Increases latency and API costs. Default: false (uses intelligent caching).", "type": "boolean" }, "postIds": { "description": "Array of Instagram post IDs to fetch (1-50 IDs). Returns only found posts, omitting not-found IDs. REQUIRED FORMAT: strong_id (e.g., \"3606450040306139062_4836333238\"). This is the complete post identifier consisting of media_id + underscore + user_id. When receiving the post id from other instagram tools, use the full \"id\" value. DO NOT use only the media_id portion.", "items": { "pattern": "^\\d+_\\d+$", "type": "string" }, "maxItems": 50, "minItems": 1, "type": "array" }, "userPrompt": { "description": "CRITICAL FOR ACCURACY: Include the complete user question to enable query optimization and context-aware filtering. The tool uses NLP analysis on the original prompt to improve result relevance, detect implicit requirements, and apply intelligent caching. Omitting this may result in suboptimal or incomplete results.", "type": "string" } }, "required": [ "postIds" ], "type": "object" }, "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": true, "readOnlyHint": true, "title": "Instagram: Get Posts by IDs" } }, { "name": "getInstagramPostsByUser", "description": "Get posts from Instagram user by ID or username with two response modes. Use identifierType=\"id\" for numeric user ID, identifierType=\"username\" for username. FAST (default, omit responseType or responseType=\"fast\"): Returns up to 300 results directly (use limit param to reduce, e.g. limit=5). Auto API fallback for fresh data. Results include guidance for full mode. PAGING (responseType=\"paging\"): Async paginated results (100/page), returns operationId for polling via checkOperationStatus. Supports pageNumber/tableName for subsequent pages. CSV (responseType=\"csv\"): Async single CSV download, returns operationId, poll for S3 link. CODE EXECUTION: For csv mode, download CSV and use code execution to analyze full dataset. Ideal for: engagement analysis, content trends, posting patterns across all posts. Returns by default: id, caption, username, createdAtDate. Date filters: OMIT startDate/endDate parameters by default to retrieve all posts. ONLY pass these if user explicitly requests specific date range (YYYY-MM-DD format). \n IMPORTANT!!!!!: THE CURRENT YEAR IS 2026.\n When user requests relative dates (last week, last month), verify the current date from your \n system context and double-check the calculated dates - models often get the year wrong, searching one year earlier than intended. \nFIELDS parameter (optional): Specify to get additional/different fields. Available: Core (id, caption, userId, username, fullName, createdAtDate), Engagement (likeCount, commentCount, reshareCount, mediaRepostCount, saveCount, videoPlayCount), Media (mediaType, imageUrl, videoUrl, subtitles, videoDuration). This is a safe, read-only tool for analyzing searchable information. ", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "_isTrial": { "type": "boolean" }, "_requestId": { "type": "string" }, "_trialToken": { "type": "string" }, "endDate": { "type": "string" }, "feedback": { "description": "Optional. Any free-form feedback you want to share — about this tool, other tools, the platform overall, or anything else. Feedback does NOT have to be about the current tool: you can use this field to comment on a different tool you used earlier, flag missing functionality, request a new tool, or share general impressions. Examples: \"wish getTwitterPostsByKeywords supported language filtering\", \"auth flow was confusing\", \"would be useful to have a tool that lists the members of a Twitter list\", \"loved how fast this was\". Captured for product feedback; does not affect tool behavior.", "type": "string" }, "fields": { "description": "PERFORMANCE OPTIMIZATION: Specify fields you need. DEFAULT (if omitted): [\"id\", \"caption\", \"username\", \"createdAtDate\"]. AVAILABLE FIELDS: Core: id, postType, userId, username, fullName, caption, createdAt, createdAtTimestamp, createdAtDate. Engagement: likeCount, commentCount, reshareCount, mediaRepostCount, saveCount, videoPlayCount. Media: mediaType, codeUrl, imageUrl, videoUrl, audioOnlyUrl, profilePicUrl, videoSubtitlesUri, subtitles, videoDuration. EXAMPLES: [\"id\", \"caption\"] for minimal, [\"id\", \"caption\", \"username\", \"createdAtDate\", \"likeCount\"] for basic analysis, or specify all fields if needed.", "items": { "type": "string" }, "type": "array" }, "forceLatest": { "description": "USE SPARINGLY: Force fetching the latest data from the API, bypassing cache checks. Only use when explicitly required (e.g., \"get the latest\", \"most recent\", \"real-time\"). WARNING: Increases latency and API costs. Default: false (uses intelligent caching).", "type": "boolean" }, "identifier": { "description": "User ID (numeric) or username depending on identifierType.", "minLength": 1, "type": "string" }, "identifierType": { "description": "Type of identifier provided. Use \"id\" for numeric user ID, \"username\" for username.", "enum": [ "id", "username" ], "type": "string" }, "limit": { "description": "Max results to return. Fast mode: capped at 300 (default: 300). Paging/CSV modes: caps total exported rows (default: all, max 500K).", "maximum": 500000, "minimum": 1, "type": "number" }, "pageNumber": { "description": "Page number to fetch (1-indexed). Must be provided with tableName to fetch subsequent pages. Omit for first page.", "minimum": 1, "type": "number" }, "pageNumberEnd": { "description": "Optional ending page number for fetching multiple consecutive pages at once (e.g., pageNumber=1, pageNumberEnd=5 fetches pages 1-5). Must be \u003e= pageNumber. Omit to fetch single page only. Requires tableName.", "minimum": 1, "type": "number" }, "responseType": { "description": "Response mode. \"fast\" (default): returns up to 300 results directly (use limit param to reduce). \"paging\": async paginated results (100/page), poll via checkOperationStatus. \"csv\": async single CSV download, poll for S3 link.", "enum": [ "fast", "paging", "csv" ], "type": "string" }, "startDate": { "type": "string" }, "tableName": { "description": "Cached table name from previous pagination request. Required when fetching pageNumber \u003e 1. Returned in first page response.", "type": "string" }, "userPrompt": { "description": "CRITICAL FOR ACCURACY: Include the complete user question to enable query optimization and context-aware filtering. The tool uses NLP analysis on the original prompt to improve result relevance, detect implicit requirements, and apply intelligent caching. Omitting this may result in suboptimal or incomplete results.", "type": "string" } }, "required": [ "identifier", "identifierType" ], "type": "object" }, "annotations": { "destructiveHint": false, "idempotentHint": false, "openWorldHint": true, "readOnlyHint": true, "title": "Instagram: Get Posts by User" } }, { "name": "getInstagramPostsByKeywords", "description": "Search Instagram posts by keywords with two response modes. Searches in both post captions and video subtitles. FAST (default, omit responseType or responseType=\"fast\"): Returns up to 300 results directly (use limit param to reduce, e.g. limit=5). Auto API fallback for fresh data. Results include guidance for full mode. PAGING (responseType=\"paging\"): Async paginated results (100/page), returns operationId for polling via checkOperationStatus. Supports pageNumber/tableName for subsequent pages. CSV (responseType=\"csv\"): Async single CSV download, returns operationId, poll for S3 link. CODE EXECUTION: For csv mode, download CSV and use code execution to analyze full dataset. Ideal for: content analysis, hashtag trends, brand monitoring across thousands of posts. Returns by default: id, caption, username, createdAtDate. First searches database, then external API if data is stale or missing. NOT for URL lookups or post ID lookups - use getInstagramPostsByIds instead. Query must be plain text keywords/phrases, not URLs or IDs. QUERY SYNTAX: Plain keywords (bitcoin, climate change), quoted phrases (\"deep learning\"), boolean expressions (AI AND crypto, bitcoin OR ethereum, politics NOT sports), or parenthesized groups ((startup OR entrepreneur) NOT \"venture capital\"). AND/OR/NOT must have a term on both sides. @handles like @karpathy are supported. Field operators (from:, lang:) are stripped. Forward slashes are treated as spaces (24/7 becomes 24 7). Date filters: OMIT startDate/endDate parameters by default. ONLY pass these if user explicitly requests specific date range (YYYY-MM-DD format). \n IMPORTANT!!!!!: THE CURRENT YEAR IS 2026.\n When user requests relative dates (last week, last month), verify the current date from your \n system context and double-check the calculated dates - models often get the year wrong, searching one year earlier than intended. \nFIELDS parameter (optional): Specify to get additional/different fields. Available: Core (id, caption, userId, username, fullName, createdAtDate), Engagement (likeCount, commentCount, reshareCount, mediaRepostCount, saveCount, videoPlayCount), Media (mediaType, imageUrl, videoUrl, subtitles, videoDuration). This is a safe, read-only tool for analyzing searchable information. ", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "_isTrial": { "type": "boolean" }, "_requestId": { "type": "string" }, "_trialToken": { "type": "string" }, "endDate": { "type": "string" }, "feedback": { "description": "Optional. Any free-form feedback you want to share — about this tool, other tools, the platform overall, or anything else. Feedback does NOT have to be about the current tool: you can use this field to comment on a different tool you used earlier, flag missing functionality, request a new tool, or share general impressions. Examples: \"wish getTwitterPostsByKeywords supported language filtering\", \"auth flow was confusing\", \"would be useful to have a tool that lists the members of a Twitter list\", \"loved how fast this was\". Captured for product feedback; does not affect tool behavior.", "type": "string" }, "fields": { "description": "PERFORMANCE OPTIMIZATION: Specify fields you need. DEFAULT (if omitted): [\"id\", \"caption\", \"username\", \"createdAtDate\"]. AVAILABLE FIELDS: Core: id, postType, userId, username, fullName, caption, createdAt, createdAtTimestamp, createdAtDate. Engagement: likeCount, commentCount, reshareCount, mediaRepostCount, saveCount, videoPlayCount. Media: mediaType, codeUrl, imageUrl, videoUrl, audioOnlyUrl, profilePicUrl, videoSubtitlesUri, subtitles, videoDuration. EXAMPLES: [\"id\", \"caption\"] for minimal, [\"id\", \"caption\", \"username\", \"createdAtDate\", \"likeCount\"] for basic analysis, or specify all fields if needed.", "items": { "type": "string" }, "type": "array" }, "forceLatest": { "description": "USE SPARINGLY: Force fetching the latest data from the API, bypassing cache checks. Only use when explicitly required (e.g., \"get the latest\", \"most recent\", \"real-time\"). WARNING: Increases latency and API costs. Default: false (uses intelligent caching).", "type": "boolean" }, "limit": { "description": "Max results to return. Fast mode: capped at 300 (default: 300). Paging/CSV modes: caps total exported rows (default: all, max 500K).", "maximum": 500000, "minimum": 1, "type": "number" }, "pageNumber": { "description": "Page number to fetch (1-indexed). Must be provided with tableName to fetch subsequent pages. Omit for first page.", "minimum": 1, "type": "number" }, "pageNumberEnd": { "description": "Optional ending page number for fetching multiple consecutive pages at once (e.g., pageNumber=1, pageNumberEnd=5 fetches pages 1-5). Must be \u003e= pageNumber. Omit to fetch single page only. Requires tableName.", "minimum": 1, "type": "number" }, "query": { "description": "Plain text keywords or phrases to search in post captions and subtitles. Use double quotes for exact phrases. Do NOT pass URLs, post IDs, or special syntax - only search terms. Examples: \"travel photography\", food OR cooking, \"sunset beach\" AND california", "maxLength": 250, "minLength": 1, "type": "string" }, "responseType": { "description": "Response mode. \"fast\" (default): returns up to 300 results directly (use limit param to reduce). \"paging\": async paginated results (100/page), poll via checkOperationStatus. \"csv\": async single CSV download, poll for S3 link.", "enum": [ "fast", "paging", "csv" ], "type": "string" }, "startDate": { "type": "string" }, "tableName": { "description": "Cached table name from previous pagination request. Required when fetching pageNumber \u003e 1. Returned in first page response.", "type": "string" }, "userPrompt": { "description": "CRITICAL FOR ACCURACY: Include the complete user question to enable query optimization and context-aware filtering. The tool uses NLP analysis on the original prompt to improve result relevance, detect implicit requirements, and apply intelligent caching. Omitting this may result in suboptimal or incomplete results.", "type": "string" } }, "required": [ "query" ], "type": "object" }, "annotations": { "destructiveHint": false, "idempotentHint": false, "openWorldHint": true, "readOnlyHint": true, "title": "Instagram: Get Posts by Keywords" } }, { "name": "getInstagramUser", "description": "Get Instagram user profile by ID or username. Use identifierType=\"id\" for numeric user ID, identifierType=\"username\" for username. For username: Use ONLY when you have the precise username (e.g., \"cristiano\"). For person names or fuzzy search, use searchInstagramUsers instead. Optional fields parameter for performance (default: [\"id\", \"username\", \"fullName\"]). Available fields: id, username, fullName, biography, isPrivate, isVerified, followerCount, followingCount, mediaCount, profilePicUrl, and more. Returns: single user profile with userId, username, fullName, followerCount, followingCount, mediaCount, biography, isVerified, isPrivate, profilePicUrl. This is a safe, read-only tool for analyzing searchable information. ", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "_isTrial": { "type": "boolean" }, "_requestId": { "type": "string" }, "_trialToken": { "type": "string" }, "feedback": { "description": "Optional. Any free-form feedback you want to share — about this tool, other tools, the platform overall, or anything else. Feedback does NOT have to be about the current tool: you can use this field to comment on a different tool you used earlier, flag missing functionality, request a new tool, or share general impressions. Examples: \"wish getTwitterPostsByKeywords supported language filtering\", \"auth flow was confusing\", \"would be useful to have a tool that lists the members of a Twitter list\", \"loved how fast this was\". Captured for product feedback; does not affect tool behavior.", "type": "string" }, "fields": { "description": "PERFORMANCE OPTIMIZATION: Specify fields you need. DEFAULT (if omitted): [\"id\", \"username\", \"fullName\"]. AVAILABLE FIELDS: Core: id, username, fullName, biography, isPrivate, isVerified. Engagement: followerCount, followingCount, mediaCount. Profile: profilePicUrl, profilePicId, profileUrl, externalUrl, hasAnonymousProfilePicture. EXAMPLES: [\"id\", \"username\"] for minimal, [\"username\", \"fullName\", \"followerCount\"] for basic info, or specify all fields if needed.", "items": { "type": "string" }, "type": "array" }, "forceLatest": { "description": "USE SPARINGLY: Force fetching the latest data from the API, bypassing cache checks. Only use when explicitly required (e.g., \"get the latest\", \"most recent\", \"real-time\"). WARNING: Increases latency and API costs. Default: false (uses intelligent caching).", "type": "boolean" }, "identifier": { "description": "User ID (numeric) or username depending on identifierType.", "minLength": 1, "type": "string" }, "identifierType": { "description": "Type of identifier provided. Use \"id\" for numeric user ID, \"username\" for username.", "enum": [ "id", "username" ], "type": "string" }, "userPrompt": { "description": "CRITICAL FOR ACCURACY: Include the complete user question to enable query optimization and context-aware filtering. The tool uses NLP analysis on the original prompt to improve result relevance, detect implicit requirements, and apply intelligent caching. Omitting this may result in suboptimal or incomplete results.", "type": "string" } }, "required": [ "identifier", "identifierType" ], "type": "object" }, "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": true, "readOnlyHint": true, "title": "Instagram: Get User" } }, { "name": "searchInstagramUsers", "description": "Search users by person name, partial username, or fuzzy match using real-time external API. PRIMARY USE: When given person's name (e.g., \"Cristiano Ronaldo\", \"Kim Kardashian\"), partial info, or uncertain username. Use for: Name-based search, finding multiple candidates, fuzzy matching, discovering users. NOT for: Exact username lookup (use getInstagramUser when username is certain). Optional fields parameter for performance (default: [\"id\", \"username\", \"fullName\"]). Available fields: id, username, fullName, biography, isPrivate, isVerified, followerCount, followingCount, mediaCount, profilePicUrl, and more. Returns: array of matching users (default 10, max 10) with userId, username, fullName, followerCount, biography, profilePicUrl. This is a safe, read-only tool for analyzing searchable information. ", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "_isTrial": { "type": "boolean" }, "_requestId": { "type": "string" }, "_trialToken": { "type": "string" }, "feedback": { "description": "Optional. Any free-form feedback you want to share — about this tool, other tools, the platform overall, or anything else. Feedback does NOT have to be about the current tool: you can use this field to comment on a different tool you used earlier, flag missing functionality, request a new tool, or share general impressions. Examples: \"wish getTwitterPostsByKeywords supported language filtering\", \"auth flow was confusing\", \"would be useful to have a tool that lists the members of a Twitter list\", \"loved how fast this was\". Captured for product feedback; does not affect tool behavior.", "type": "string" }, "fields": { "description": "PERFORMANCE OPTIMIZATION: Specify fields you need. DEFAULT (if omitted): [\"id\", \"username\", \"fullName\"]. AVAILABLE FIELDS: Core: id, username, fullName, biography, isPrivate, isVerified. Engagement: followerCount, followingCount, mediaCount. Profile: profilePicUrl, profilePicId, profileUrl, externalUrl, hasAnonymousProfilePicture. EXAMPLES: [\"id\", \"username\"] for minimal, [\"username\", \"fullName\", \"followerCount\"] for basic info, or specify all fields if needed.", "items": { "type": "string" }, "type": "array" }, "limit": { "description": "Maximum number of users to return. Default: 10, Max: 10.", "maximum": 10, "minimum": 1, "type": "number" }, "name": { "description": "Search query for Instagram users. Supports partial name or username matching.", "minLength": 1, "type": "string" }, "userPrompt": { "description": "CRITICAL FOR ACCURACY: Include the complete user question to enable query optimization and context-aware filtering. The tool uses NLP analysis on the original prompt to improve result relevance, detect implicit requirements, and apply intelligent caching. Omitting this may result in suboptimal or incomplete results.", "type": "string" } }, "required": [ "name" ], "type": "object" }, "annotations": { "destructiveHint": false, "idempotentHint": false, "openWorldHint": true, "readOnlyHint": true, "title": "Instagram: Search Users" } }, { "name": "getInstagramUserConnections", "description": "Get Instagram user connections (followers or following). Use connectionType=\"followers\" for users who follow them, connectionType=\"following\" for users they follow. FAST (default, omit responseType or responseType=\"fast\"): Returns up to 300 results directly (use limit param to reduce, e.g. limit=5). Auto API fallback for fresh data. PAGING (responseType=\"paging\"): Async paginated results (100 users per page), returns operationId for polling via checkOperationStatus. Supports pageNumber/tableName for subsequent pages. Optional fields parameter for performance (default: [\"id\", \"username\", \"fullName\"]). Available fields: id, username, fullName, biography, isPrivate, isVerified, followerCount, followingCount, mediaCount, profilePicUrl, and more. DATA FRESHNESS: Automatically checks data age (\u003e 1 week triggers refresh from API). FORCE LATEST: Use sparingly - forceLatest=true bypasses cache for real-time data (increases latency/costs). CRITICAL - Understanding totalRows vs totalDataCount: totalRows indicates ONLY what we have in our database. totalDataCount (when present) shows the actual count from Instagram. If totalDataCount is missing or undefined, you CANNOT claim totalRows represents all connections - it only shows our partial database data. If totalDataCount \u003e totalRows, we only have partial data. Always check if totalDataCount exists before making claims about total counts. This is a safe, read-only tool for analyzing searchable information. ", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "_isTrial": { "type": "boolean" }, "_requestId": { "type": "string" }, "_trialToken": { "type": "string" }, "connectionType": { "description": "Type of connection to retrieve. Use \"followers\" for users who follow this account, \"following\" for users this account follows.", "enum": [ "followers", "following" ], "type": "string" }, "feedback": { "description": "Optional. Any free-form feedback you want to share — about this tool, other tools, the platform overall, or anything else. Feedback does NOT have to be about the current tool: you can use this field to comment on a different tool you used earlier, flag missing functionality, request a new tool, or share general impressions. Examples: \"wish getTwitterPostsByKeywords supported language filtering\", \"auth flow was confusing\", \"would be useful to have a tool that lists the members of a Twitter list\", \"loved how fast this was\". Captured for product feedback; does not affect tool behavior.", "type": "string" }, "fields": { "description": "PERFORMANCE OPTIMIZATION: Specify fields you need. DEFAULT (if omitted): [\"id\", \"username\", \"fullName\"]. AVAILABLE FIELDS: Core: id, username, fullName, biography, isPrivate, isVerified. Engagement: followerCount, followingCount, mediaCount. Profile: profilePicUrl, profilePicId, profileUrl, externalUrl, hasAnonymousProfilePicture. EXAMPLES: [\"id\", \"username\"] for minimal, [\"username\", \"fullName\", \"followerCount\"] for basic info, or specify all fields if needed.", "items": { "type": "string" }, "type": "array" }, "forceLatest": { "description": "USE SPARINGLY: Force fetching the latest data from the API, bypassing cache checks. Only use when explicitly required (e.g., \"get the latest\", \"most recent\", \"real-time\"). WARNING: Increases latency and API costs. Default: false (uses intelligent caching).", "type": "boolean" }, "limit": { "description": "Max results to return. Fast mode: capped at 300 (default: 300). Paging/CSV modes: caps total exported rows (default: all, max 500K).", "maximum": 500000, "minimum": 1, "type": "number" }, "pageNumber": { "description": "Page number to fetch (1-indexed). Must be provided with tableName to fetch subsequent pages. Omit for first page.", "minimum": 1, "type": "number" }, "pageNumberEnd": { "description": "Optional ending page number for fetching multiple consecutive pages at once (e.g., pageNumber=1, pageNumberEnd=5 fetches pages 1-5). Must be \u003e= pageNumber. Omit to fetch single page only. Requires tableName.", "minimum": 1, "type": "number" }, "responseType": { "description": "Response mode. \"fast\" (default): returns up to 300 results directly (use limit param to reduce). \"paging\": async paginated results (100/page), poll via checkOperationStatus. \"csv\": async single CSV download, poll for S3 link.", "enum": [ "fast", "paging" ], "type": "string" }, "tableName": { "description": "Cached table name from previous pagination request. Required when fetching pageNumber \u003e 1. Returned in first page response.", "type": "string" }, "userPrompt": { "description": "CRITICAL FOR ACCURACY: Include the complete user question to enable query optimization and context-aware filtering. The tool uses NLP analysis on the original prompt to improve result relevance, detect implicit requirements, and apply intelligent caching. Omitting this may result in suboptimal or incomplete results.", "type": "string" }, "username": { "description": "Instagram username (without @ symbol)", "minLength": 1, "pattern": "^@?[a-zA-Z0-9._]{1,30}$", "type": "string" } }, "required": [ "username", "connectionType" ], "type": "object" }, "annotations": { "destructiveHint": false, "idempotentHint": false, "openWorldHint": true, "readOnlyHint": true, "title": "Instagram: Get User Connections" } }, { "name": "getInstagramPostInteractingUsers", "description": "Get USER PROFILES of people who interacted with an Instagram post. Returns full user data (bio, followerCount, followingCount, etc.). RETURNS USER PROFILES: id, username, fullName, biography, followerCount, followingCount, isVerified, profilePicUrl. Use for analyzing WHO engaged with a post. NOT FOR COMMENT TEXT: To read the actual comment content (what people wrote), use getInstagramCommentsByPostId instead. INTERACTION TYPES: \"commenters\" (users who commented), \"likers\" (users who liked). WHEN TO USE THIS TOOL: Analyzing commenters/likers demographics, finding influencers who engaged, building audience profiles, network analysis of who interacts with posts. WHEN TO USE getInstagramCommentsByPostId: Reading comment text, sentiment analysis of what was said, analyzing discussion content. FAST (default, omit responseType or responseType=\"fast\"): Returns up to 300 results directly (use limit param to reduce, e.g. limit=5). Auto API fallback for commenters when stale. PAGING (responseType=\"paging\"): Async paginated results (1000 users per page with default fields), returns operationId - IMMEDIATELY call checkOperationStatus to get results. CSV export included via dataDumpExportOperationId. Supports pageNumber/tableName for subsequent pages. Optional fields (default: [\"id\", \"username\", \"fullName\"]). Available: biography, isPrivate, isVerified, followerCount, followingCount, mediaCount, profilePicUrl. This is a safe, read-only tool for analyzing searchable information. ", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "_isTrial": { "type": "boolean" }, "_requestId": { "type": "string" }, "_trialToken": { "type": "string" }, "feedback": { "description": "Optional. Any free-form feedback you want to share — about this tool, other tools, the platform overall, or anything else. Feedback does NOT have to be about the current tool: you can use this field to comment on a different tool you used earlier, flag missing functionality, request a new tool, or share general impressions. Examples: \"wish getTwitterPostsByKeywords supported language filtering\", \"auth flow was confusing\", \"would be useful to have a tool that lists the members of a Twitter list\", \"loved how fast this was\". Captured for product feedback; does not affect tool behavior.", "type": "string" }, "fields": { "description": "PERFORMANCE OPTIMIZATION: Specify fields you need. DEFAULT (if omitted): [\"id\", \"username\", \"fullName\"]. AVAILABLE FIELDS: Core: id, username, fullName, biography, isPrivate, isVerified. Engagement: followerCount, followingCount, mediaCount. Profile: profilePicUrl, profilePicId, profileUrl, externalUrl, hasAnonymousProfilePicture. EXAMPLES: [\"id\", \"username\"] for minimal, [\"username\", \"fullName\", \"followerCount\"] for basic info, or specify all fields if needed.", "items": { "type": "string" }, "type": "array" }, "forceLatest": { "description": "USE SPARINGLY: Force fetching the latest data from the API, bypassing cache checks. Only use when explicitly required (e.g., \"get the latest\", \"most recent\", \"real-time\"). WARNING: Increases latency and API costs. Default: false (uses intelligent caching).", "type": "boolean" }, "interactionType": { "description": "Type of interaction to retrieve users for. Options: \"commenters\" (users who commented on the post), \"likers\" (users who liked the post). Each type queries different relationships in the data.", "enum": [ "commenters", "likers" ], "type": "string" }, "limit": { "description": "Max results to return. Fast mode: capped at 300 (default: 300). Paging/CSV modes: caps total exported rows (default: all, max 500K).", "maximum": 500000, "minimum": 1, "type": "number" }, "pageNumber": { "description": "Page number to fetch (1-indexed). Must be provided with tableName to fetch subsequent pages. Omit for first page.", "minimum": 1, "type": "number" }, "pageNumberEnd": { "description": "Optional ending page number for fetching multiple consecutive pages at once (e.g., pageNumber=1, pageNumberEnd=5 fetches pages 1-5). Must be \u003e= pageNumber. Omit to fetch single page only. Requires tableName.", "minimum": 1, "type": "number" }, "postId": { "description": "REQUIRED FORMAT: strong_id (e.g., \"3606450040306139062_4836333238\"). This is the complete post identifier consisting of media_id + underscore + user_id. When receiving the post id from other instagram tools, use the full \"id\" valueDO NOT use only the media_id portion.", "pattern": "^\\d+_\\d+$", "type": "string" }, "responseType": { "description": "Response mode. \"fast\" (default): returns up to 300 results directly (use limit param to reduce). \"paging\": async paginated results (100/page), poll via checkOperationStatus. \"csv\": async single CSV download, poll for S3 link.", "enum": [ "fast", "paging" ], "type": "string" }, "tableName": { "description": "Cached table name from previous pagination request. Required when fetching pageNumber \u003e 1. Returned in first page response.", "type": "string" }, "userPrompt": { "description": "CRITICAL FOR ACCURACY: Include the complete user question to enable query optimization and context-aware filtering. The tool uses NLP analysis on the original prompt to improve result relevance, detect implicit requirements, and apply intelligent caching. Omitting this may result in suboptimal or incomplete results.", "type": "string" } }, "required": [ "postId", "interactionType" ], "type": "object" }, "annotations": { "destructiveHint": false, "idempotentHint": false, "openWorldHint": true, "readOnlyHint": true, "title": "Instagram: Get Post Interacting Users" } }, { "name": "getInstagramUsersByKeywords", "description": "Search for USERS who authored Instagram posts matching keywords. USE CASE: Find users who have posted content about specific topics, keywords, or phrases. Returns unique, deduplicated user profiles. RESPONSE MODES (responseType parameter): \"fast\" (DEFAULT): Returns up to 300 results directly in one call. Use limit param to reduce. Best for quick lookups. \"paging\": Async paginated results (100/page). Returns operation ID - call checkOperationStatus to get results. Use pageNumber/tableName for subsequent pages. \"csv\": Async CSV export. Returns dataDumpExportOperationId - call checkOperationStatus to get S3 download link. Best for bulk export. PAGING MODE DETAILS: FIRST CALL: Omit pageNumber and tableName. Creates cached table, returns page 1 with pagination metadata (tableName, totalPages, totalRows). SUBSEQUENT PAGES: Use tableName from first response with pageNumber (2, 3, etc.). BULK FETCH: Use pageNumberEnd with pageNumber and tableName for multiple consecutive pages. QUERY SYNTAX: Plain keywords (bitcoin, climate change), quoted phrases (\"deep learning\"), boolean expressions (AI AND crypto, bitcoin OR ethereum, politics NOT sports), or parenthesized groups ((startup OR entrepreneur) NOT \"venture capital\"). AND/OR/NOT must have a term on both sides. @handles like @karpathy are supported. Field operators (from:, lang:) are stripped. Forward slashes are treated as spaces (24/7 becomes 24 7). FILTERS: - startDate/endDate: Filter by post date (YYYY-MM-DD format). OMIT by default, only use if user explicitly requests date range. \n IMPORTANT!!!!!: THE CURRENT YEAR IS 2026.\n When user requests relative dates (last week, last month), verify the current date from your \n system context and double-check the calculated dates - models often get the year wrong, searching one year earlier than intended. \nOptional fields parameter for performance (default: [\"id\", \"username\", \"fullName\"]). Available fields: id, username, fullName, biography, isPrivate, isVerified, followerCount, followingCount, mediaCount, profilePicUrl, and more. AGGREGATE FIELDS (from matching posts) - MUST BE EXPLICITLY REQUESTED IN FIELDS: aggRelevance (relevance score for sorting), relevantPostsCount (count of matching posts per user), relevantPostsLikesSum, relevantPostsCommentsSum, relevantPostsResharesSum, relevantPostsMediaRepostsSum, relevantPostsSavesSum, relevantPostsVideoPlaysSum. These return aggregated metrics from all matched posts for each user. Returns: results array of unique user profiles, count. In paging mode: pagination object, dataDumpExportOperationId for CSV. This is a safe, read-only tool for analyzing searchable information. ", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "_isTrial": { "type": "boolean" }, "_requestId": { "type": "string" }, "_trialToken": { "type": "string" }, "endDate": { "type": "string" }, "feedback": { "description": "Optional. Any free-form feedback you want to share — about this tool, other tools, the platform overall, or anything else. Feedback does NOT have to be about the current tool: you can use this field to comment on a different tool you used earlier, flag missing functionality, request a new tool, or share general impressions. Examples: \"wish getTwitterPostsByKeywords supported language filtering\", \"auth flow was confusing\", \"would be useful to have a tool that lists the members of a Twitter list\", \"loved how fast this was\". Captured for product feedback; does not affect tool behavior.", "type": "string" }, "fields": { "description": "PERFORMANCE OPTIMIZATION: Specify fields you need. DEFAULT (if omitted): [\"id\", \"username\", \"fullName\"]. AVAILABLE FIELDS: Core: id, username, fullName, biography, isPrivate, isVerified. Engagement: followerCount, followingCount, mediaCount. Profile: profilePicUrl, profilePicId, profileUrl, externalUrl, hasAnonymousProfilePicture. Aggregations (from matching posts, not all posts of the user): aggRelevance (relevance score), relevantPostsCount (count of matching posts), relevantPostsLikesSum, relevantPostsCommentsSum, relevantPostsResharesSum, relevantPostsMediaRepostsSum, relevantPostsSavesSum, relevantPostsVideoPlaysSum. EXAMPLES: [\"id\", \"username\"] for minimal, [\"username\", \"fullName\", \"followerCount\", \"relevantPostsLikesSum\", \"relevantPostsCount\"] to include engagement aggregations.", "items": { "type": "string" }, "type": "array" }, "forceLatest": { "description": "USE SPARINGLY: Force fetching the latest data from the API, bypassing cache checks. Only use when explicitly required (e.g., \"get the latest\", \"most recent\", \"real-time\"). WARNING: Increases latency and API costs. Default: false (uses intelligent caching).", "type": "boolean" }, "limit": { "description": "Max results to return. Fast mode: capped at 300 (default: 300). Paging/CSV modes: caps total exported rows (default: all, max 500K).", "maximum": 500000, "minimum": 1, "type": "number" }, "pageNumber": { "description": "Page number to fetch (1-indexed). Must be provided with tableName to fetch subsequent pages. Omit for first page.", "minimum": 1, "type": "number" }, "pageNumberEnd": { "description": "Optional ending page number for fetching multiple consecutive pages at once (e.g., pageNumber=1, pageNumberEnd=5 fetches pages 1-5). Must be \u003e= pageNumber. Omit to fetch single page only. Requires tableName.", "minimum": 1, "type": "number" }, "query": { "description": "Full-text search of Instagram post captions to find users who authored matching posts. Searches posts, returns UNIQUE user authors (deduplicated). EXACT PHRASES: Wrap in double quotes - \"sustainable fashion\" matches that exact phrase. KEYWORDS: Without quotes, matches posts containing any of the words - travel food photography. BOOLEAN OPERATORS: MUST explicitly use the keywords AND, OR, NOT (uppercase or lowercase). NO implicit operators - space between words means OR by default. Examples requiring explicit operators: Use \"travel photography\" AND nature (not \"travel photography nature\"). Use fashion OR style (not \"fashion style\"). PARENTHESES: Group terms for precise logic - (travel OR adventure) AND (\"sustainable living\" NOT luxury). FORBIDDEN: DO NOT use filter operators with colons (from:, to:, since:, until:) - use dedicated parameters instead. Query examples: \"climate change\" | fashion OR beauty | \"digital nomad\" AND remote | (startup OR entrepreneur) NOT \"venture capital\"", "maxLength": 250, "minLength": 1, "type": "string" }, "responseType": { "description": "Response mode. \"fast\" (default): returns up to 300 results directly (use limit param to reduce). \"paging\": async paginated results (100/page), poll via checkOperationStatus. \"csv\": async single CSV download, poll for S3 link.", "enum": [ "fast", "paging", "csv" ], "type": "string" }, "startDate": { "type": "string" }, "tableName": { "description": "Cached table name from previous pagination request. Required when fetching pageNumber \u003e 1. Returned in first page response.", "type": "string" }, "userPrompt": { "description": "CRITICAL FOR ACCURACY: Include the complete user question to enable query optimization and context-aware filtering. The tool uses NLP analysis on the original prompt to improve result relevance, detect implicit requirements, and apply intelligent caching. Omitting this may result in suboptimal or incomplete results.", "type": "string" } }, "required": [ "query" ], "type": "object" }, "annotations": { "destructiveHint": false, "idempotentHint": false, "openWorldHint": true, "readOnlyHint": true, "title": "Instagram: Get Users by Keywords" } }, { "name": "getInstagramCommentsByPostId", "description": "Get COMMENT CONTENT (text, likes) for an Instagram post. Returns the actual comment objects with text and metadata. RETURNS COMMENT DATA: id, text, username, createdAtDate, likeCount, childCommentCount. Use for reading what people said. NOT FOR USER PROFILES: To get detailed user profiles (bio, followerCount, followingCount) of commenters, use getInstagramPostInteractingUsers with interactionType=\"commenters\" instead. IMPORTANT: postId must be in strong_id format (e.g., \"3606450040306139062_4836333238\") - use the full \"id\" value from other Instagram tools, NOT just the media_id. FAST (default, omit responseType or responseType=\"fast\"): Returns up to 300 results directly (use limit param to reduce, e.g. limit=5). Auto API fallback for fresh data. PAGING (responseType=\"paging\"): Async paginated results (100/page), returns operationId for polling via checkOperationStatus. Supports pageNumber/tableName for subsequent pages. CSV (responseType=\"csv\"): Async single CSV download, returns operationId, poll for S3 link. CODE EXECUTION: For csv mode, download CSV and use code execution to analyze full dataset. Ideal for: sentiment analysis, reading discussions, analyzing comment content, engagement patterns. Date filters: OMIT startDate/endDate parameters by default. ONLY pass these if user explicitly requests specific date range (YYYY-MM-DD format). \n IMPORTANT!!!!!: THE CURRENT YEAR IS 2026.\n When user requests relative dates (last week, last month), verify the current date from your \n system context and double-check the calculated dates - models often get the year wrong, searching one year earlier than intended. \nOptional fields: [\"id\", \"text\", \"username\", \"createdAtDate\", \"likeCount\"]. This is a safe, read-only tool for analyzing searchable information. ", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "_isTrial": { "type": "boolean" }, "_requestId": { "type": "string" }, "_trialToken": { "type": "string" }, "endDate": { "type": "string" }, "feedback": { "description": "Optional. Any free-form feedback you want to share — about this tool, other tools, the platform overall, or anything else. Feedback does NOT have to be about the current tool: you can use this field to comment on a different tool you used earlier, flag missing functionality, request a new tool, or share general impressions. Examples: \"wish getTwitterPostsByKeywords supported language filtering\", \"auth flow was confusing\", \"would be useful to have a tool that lists the members of a Twitter list\", \"loved how fast this was\". Captured for product feedback; does not affect tool behavior.", "type": "string" }, "fields": { "description": "PERFORMANCE OPTIMIZATION: Specify fields you need. DEFAULT (if omitted): [\"id\", \"text\", \"username\", \"createdAtDate\"]. AVAILABLE FIELDS: Core: id, text, parentPostId, type, parentCommentId, repliedToCommentId, childCommentCount, userId, username, fullName, createdAt, createdAtTimestamp, createdAtDate. Engagement: likeCount. Status: status, isSpam, hasTranslation. EXAMPLES: [\"id\", \"text\"] for minimal, [\"id\", \"text\", \"username\", \"createdAtDate\", \"likeCount\"] for basic analysis, or specify all fields if needed.", "items": { "type": "string" }, "type": "array" }, "forceLatest": { "description": "USE SPARINGLY: Force fetching the latest data from the API, bypassing cache checks. Only use when explicitly required (e.g., \"get the latest\", \"most recent\", \"real-time\"). WARNING: Increases latency and API costs. Default: false (uses intelligent caching).", "type": "boolean" }, "limit": { "description": "Max results to return. Fast mode: capped at 300 (default: 300). Paging/CSV modes: caps total exported rows (default: all, max 500K).", "maximum": 500000, "minimum": 1, "type": "number" }, "pageNumber": { "description": "Page number to fetch (1-indexed). Must be provided with tableName to fetch subsequent pages. Omit for first page.", "minimum": 1, "type": "number" }, "pageNumberEnd": { "description": "Optional ending page number for fetching multiple consecutive pages at once (e.g., pageNumber=1, pageNumberEnd=5 fetches pages 1-5). Must be \u003e= pageNumber. Omit to fetch single page only. Requires tableName.", "minimum": 1, "type": "number" }, "postId": { "description": "REQUIRED FORMAT: strong_id (e.g., \"3606450040306139062_4836333238\"). This is the complete post identifier consisting of media_id + underscore + user_id. When receiving the post id from other instagram tools, use the full \"id\" valueDO NOT use only the media_id portion.", "pattern": "^\\d+_\\d+$", "type": "string" }, "responseType": { "description": "Response mode. \"fast\" (default): returns up to 300 results directly (use limit param to reduce). \"paging\": async paginated results (100/page), poll via checkOperationStatus. \"csv\": async single CSV download, poll for S3 link.", "enum": [ "fast", "paging", "csv" ], "type": "string" }, "startDate": { "type": "string" }, "tableName": { "description": "Cached table name from previous pagination request. Required when fetching pageNumber \u003e 1. Returned in first page response.", "type": "string" }, "userPrompt": { "description": "CRITICAL FOR ACCURACY: Include the complete user question to enable query optimization and context-aware filtering. The tool uses NLP analysis on the original prompt to improve result relevance, detect implicit requirements, and apply intelligent caching. Omitting this may result in suboptimal or incomplete results.", "type": "string" } }, "required": [ "postId" ], "type": "object" }, "annotations": { "destructiveHint": false, "idempotentHint": false, "openWorldHint": true, "readOnlyHint": true, "title": "Instagram: Get Post Comments" } }, { "name": "getRedditUser", "description": "Get Reddit user profile by username. Returns user profile including karma breakdown (link, comment, total), account status (gold, mod, employee), and profile info. Use without u/ prefix (e.g., \"spez\" not \"u/spez\"). Optional fields parameter for performance (default: [\"id\", \"username\", \"totalKarma\"]). Available fields: id, username, profileUrl, profilePicUrl, snoovatarImg, linkKarma, commentKarma, totalKarma, awardeeKarma, awarderKarma, isGold, isMod, isEmployee, hasVerifiedEmail, isSuspended, verified, isBlocked, acceptFollowers, hasSubscribed, hideFromRobots, prefShowSnoovatar, profileDescription, profileBannerUrl, profileTitle, createdAt. Returns: single user profile with id, username, karma metrics, account flags, and profile details. This is a safe, read-only tool for analyzing searchable information. ", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "_isTrial": { "type": "boolean" }, "_requestId": { "type": "string" }, "_trialToken": { "type": "string" }, "feedback": { "description": "Optional. Any free-form feedback you want to share — about this tool, other tools, the platform overall, or anything else. Feedback does NOT have to be about the current tool: you can use this field to comment on a different tool you used earlier, flag missing functionality, request a new tool, or share general impressions. Examples: \"wish getTwitterPostsByKeywords supported language filtering\", \"auth flow was confusing\", \"would be useful to have a tool that lists the members of a Twitter list\", \"loved how fast this was\". Captured for product feedback; does not affect tool behavior.", "type": "string" }, "fields": { "description": "PERFORMANCE OPTIMIZATION: Specify fields you need. DEFAULT (if omitted): [\"id\", \"username\", \"totalKarma\"]. AVAILABLE FIELDS: Core: id, username, profileUrl, profilePicUrl, snoovatarImg. Karma: linkKarma, commentKarma, totalKarma, awardeeKarma, awarderKarma. Status: isGold, isMod, isEmployee, hasVerifiedEmail, isSuspended, verified, isBlocked, acceptFollowers, hasSubscribed, hideFromRobots, prefShowSnoovatar. Profile: profileDescription, profileBannerUrl, profileTitle. Timestamps: createdAt, createdAtTimestamp, createdAtDate. EXAMPLES: [\"id\", \"username\"] for minimal, [\"username\", \"totalKarma\", \"profileDescription\"] for basic info.", "items": { "type": "string" }, "type": "array" }, "forceLatest": { "description": "USE SPARINGLY: Force fetching the latest data from the API, bypassing cache checks. Only use when explicitly required (e.g., \"get the latest\", \"most recent\", \"real-time\"). WARNING: Increases latency and API costs. Default: false (uses intelligent caching).", "type": "boolean" }, "userPrompt": { "description": "CRITICAL FOR ACCURACY: Include the complete user question to enable query optimization and context-aware filtering. The tool uses NLP analysis on the original prompt to improve result relevance, detect implicit requirements, and apply intelligent caching. Omitting this may result in suboptimal or incomplete results.", "type": "string" }, "username": { "description": "Reddit username (without u/ prefix)", "minLength": 1, "type": "string" } }, "required": [ "username" ], "type": "object" }, "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": true, "readOnlyHint": true, "title": "Reddit: Get User" } }, { "name": "searchRedditUsers", "description": "Search Reddit users by name, username, or profile description using real-time external API. PRIMARY USE: When given a person's name (e.g., \"spez\", \"GallowBoob\"), partial info, or uncertain username. Use for: Name-based search, finding multiple candidates, fuzzy matching, discovering users. NOT for: Exact username lookup (use getRedditUser when username is certain). Optional fields parameter for performance (default: [\"id\", \"username\", \"totalKarma\"]). Available fields: id, username, profileUrl, profilePicUrl, snoovatarImg, linkKarma, commentKarma, totalKarma, awardeeKarma, awarderKarma, isGold, isMod, isEmployee, hasVerifiedEmail, isSuspended, verified, isBlocked, acceptFollowers, hasSubscribed, hideFromRobots, prefShowSnoovatar, profileDescription, profileBannerUrl, profileTitle, createdAt. Returns: array of matching users (default 50, max 50) with id, username, karma metrics, profile info. This is a safe, read-only tool for analyzing searchable information. ", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "_isTrial": { "type": "boolean" }, "_requestId": { "type": "string" }, "_trialToken": { "type": "string" }, "feedback": { "description": "Optional. Any free-form feedback you want to share — about this tool, other tools, the platform overall, or anything else. Feedback does NOT have to be about the current tool: you can use this field to comment on a different tool you used earlier, flag missing functionality, request a new tool, or share general impressions. Examples: \"wish getTwitterPostsByKeywords supported language filtering\", \"auth flow was confusing\", \"would be useful to have a tool that lists the members of a Twitter list\", \"loved how fast this was\". Captured for product feedback; does not affect tool behavior.", "type": "string" }, "fields": { "description": "PERFORMANCE OPTIMIZATION: Specify fields you need. DEFAULT (if omitted): [\"id\", \"username\", \"totalKarma\"]. AVAILABLE FIELDS: Core: id, username, profileUrl, profilePicUrl, snoovatarImg. Karma: linkKarma, commentKarma, totalKarma, awardeeKarma, awarderKarma. Status: isGold, isMod, isEmployee, hasVerifiedEmail, isSuspended, verified, isBlocked, acceptFollowers, hasSubscribed, hideFromRobots, prefShowSnoovatar. Profile: profileDescription, profileBannerUrl, profileTitle. Timestamps: createdAt, createdAtTimestamp, createdAtDate. EXAMPLES: [\"id\", \"username\"] for minimal, [\"username\", \"totalKarma\", \"profileDescription\"] for basic info.", "items": { "type": "string" }, "type": "array" }, "limit": { "description": "Maximum number of users to return. Default: 50, Max: 50.", "maximum": 50, "minimum": 1, "type": "integer" }, "name": { "description": "Search query for Reddit users. Can be username, name, or keywords from profile.", "minLength": 1, "type": "string" }, "userPrompt": { "description": "CRITICAL FOR ACCURACY: Include the complete user question to enable query optimization and context-aware filtering. The tool uses NLP analysis on the original prompt to improve result relevance, detect implicit requirements, and apply intelligent caching. Omitting this may result in suboptimal or incomplete results.", "type": "string" } }, "required": [ "name" ], "type": "object" }, "annotations": { "destructiveHint": false, "idempotentHint": false, "openWorldHint": true, "readOnlyHint": true, "title": "Reddit: Search Users" } }, { "name": "getRedditUsersByKeywords", "description": "Search for USERS who authored Reddit posts matching keywords. USE CASE: Find users who have posted content about specific topics. Returns unique, deduplicated user profiles. RESPONSE MODES (responseType parameter): \"fast\" (DEFAULT): Returns up to 300 results directly in one call. Use limit param to reduce. Best for quick lookups. \"paging\": Async paginated results (100/page). Returns operation ID - call checkOperationStatus to get results. Use pageNumber/tableName for subsequent pages. \"csv\": Async CSV export. Returns dataDumpExportOperationId - call checkOperationStatus to get S3 download link. Best for bulk export. PAGING MODE DETAILS: FIRST CALL: Omit pageNumber and tableName. Creates cached table, returns page 1 with pagination metadata (tableName, totalPages, totalRows). SUBSEQUENT PAGES: Use tableName from first response with pageNumber (2, 3, etc.). BULK FETCH: Use pageNumberEnd with pageNumber and tableName for multiple consecutive pages. QUERY SYNTAX: Plain keywords (bitcoin, climate change), quoted phrases (\"deep learning\"), boolean expressions (AI AND crypto, bitcoin OR ethereum, politics NOT sports), or parenthesized groups ((startup OR entrepreneur) NOT \"venture capital\"). AND/OR/NOT must have a term on both sides. @handles like @karpathy are supported. Field operators (from:, lang:) are stripped. Forward slashes are treated as spaces (24/7 becomes 24 7). FILTERS: - startDate/endDate: Filter by post date (YYYY-MM-DD format). OMIT by default, only use if user explicitly requests date range. \n IMPORTANT!!!!!: THE CURRENT YEAR IS 2026.\n When user requests relative dates (last week, last month), verify the current date from your \n system context and double-check the calculated dates - models often get the year wrong, searching one year earlier than intended. \n- subreddit: Filter to specific subreddit (without r/ prefix). Optional fields parameter for performance (default: [\"id\", \"username\", \"totalKarma\"]). Available fields: id, username, profileUrl, profilePicUrl, snoovatarImg, linkKarma, commentKarma, totalKarma, profileDescription, and more. AGGREGATE FIELDS (from matching posts) - MUST BE EXPLICITLY REQUESTED IN FIELDS: aggRelevance (relevance score for sorting), relevantPostsCount (count of matching posts per user), relevantPostsUpvotesSum, relevantPostsCommentsCountSum. These return aggregated metrics from all matched posts for each user. This is a safe, read-only tool for analyzing searchable information. ", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "_isTrial": { "type": "boolean" }, "_requestId": { "type": "string" }, "_trialToken": { "type": "string" }, "endDate": { "description": "End date filter (YYYY-MM-DD format)", "type": "string" }, "feedback": { "description": "Optional. Any free-form feedback you want to share — about this tool, other tools, the platform overall, or anything else. Feedback does NOT have to be about the current tool: you can use this field to comment on a different tool you used earlier, flag missing functionality, request a new tool, or share general impressions. Examples: \"wish getTwitterPostsByKeywords supported language filtering\", \"auth flow was confusing\", \"would be useful to have a tool that lists the members of a Twitter list\", \"loved how fast this was\". Captured for product feedback; does not affect tool behavior.", "type": "string" }, "fields": { "description": "PERFORMANCE OPTIMIZATION: Specify fields you need. DEFAULT (if omitted): [\"id\", \"username\", \"totalKarma\"]. AVAILABLE FIELDS: Core: id, username, profileUrl, profilePicUrl, snoovatarImg. Karma: linkKarma, commentKarma, totalKarma, awardeeKarma, awarderKarma. Status: isGold, isMod, isEmployee, hasVerifiedEmail, isSuspended, verified, isBlocked, acceptFollowers, hasSubscribed, hideFromRobots, prefShowSnoovatar. Profile: profileDescription, profileBannerUrl, profileTitle. Timestamps: createdAt, createdAtTimestamp, createdAtDate. Aggregations (from matching posts): aggRelevance (relevance score), relevantPostsCount (count of matching posts), relevantPostsUpvotesSum, relevantPostsCommentsCountSum. EXAMPLES: [\"id\", \"username\"] for minimal, [\"username\", \"totalKarma\", \"relevantPostsCount\", \"relevantPostsUpvotesSum\"] to include engagement aggregations.", "items": { "type": "string" }, "type": "array" }, "forceLatest": { "description": "USE SPARINGLY: Force fetching the latest data from the API, bypassing cache checks. Only use when explicitly required (e.g., \"get the latest\", \"most recent\", \"real-time\"). WARNING: Increases latency and API costs. Default: false (uses intelligent caching).", "type": "boolean" }, "limit": { "description": "Max results to return. Fast mode: capped at 300 (default: 300). Paging/CSV modes: caps total exported rows (default: all, max 500K).", "maximum": 500000, "minimum": 1, "type": "number" }, "pageNumber": { "description": "Page number to fetch (1-indexed). Must be provided with tableName to fetch subsequent pages. Omit for first page.", "minimum": 1, "type": "number" }, "pageNumberEnd": { "description": "Optional ending page number for fetching multiple consecutive pages at once (e.g., pageNumber=1, pageNumberEnd=5 fetches pages 1-5). Must be \u003e= pageNumber. Omit to fetch single page only. Requires tableName.", "minimum": 1, "type": "number" }, "query": { "description": "Full-text search of Reddit post titles and content to find users who authored matching posts. Searches posts, returns UNIQUE user authors (deduplicated). EXACT PHRASES: Wrap in double quotes - \"machine learning\" matches that exact phrase. KEYWORDS: Without quotes, matches posts containing any of the words - python tutorial help. BOOLEAN OPERATORS: MUST explicitly use the keywords AND, OR, NOT (uppercase or lowercase). NO implicit operators - space between words means OR by default. Examples requiring explicit operators: Use \"python tutorial\" AND beginner (not \"python tutorial beginner\"). Use programming OR coding (not \"programming coding\"). PARENTHESES: Group terms for precise logic - (python OR javascript) AND (\"web development\" NOT framework). FORBIDDEN: DO NOT use filter operators with colons (from:, to:, since:, until:) - use dedicated parameters instead. Query examples: \"machine learning\" | python help | \"data science\" AND visualization | (gaming OR esports) NOT \"mobile games\"", "maxLength": 250, "minLength": 1, "type": "string" }, "responseType": { "description": "Response mode. \"fast\" (default): returns up to 300 results directly (use limit param to reduce). \"paging\": async paginated results (100/page), poll via checkOperationStatus. \"csv\": async single CSV download, poll for S3 link.", "enum": [ "fast", "paging", "csv" ], "type": "string" }, "startDate": { "description": "Start date filter (YYYY-MM-DD format)", "type": "string" }, "subreddit": { "description": "Filter results to a specific subreddit (without r/ prefix)", "type": "string" }, "tableName": { "description": "Cached table name from previous pagination request. Required when fetching pageNumber \u003e 1. Returned in first page response.", "type": "string" }, "userPrompt": { "description": "CRITICAL FOR ACCURACY: Include the complete user question to enable query optimization and context-aware filtering. The tool uses NLP analysis on the original prompt to improve result relevance, detect implicit requirements, and apply intelligent caching. Omitting this may result in suboptimal or incomplete results.", "type": "string" } }, "required": [ "query" ], "type": "object" }, "annotations": { "destructiveHint": false, "idempotentHint": false, "openWorldHint": true, "readOnlyHint": true, "title": "Reddit: Get Users by Keywords" } }, { "name": "getRedditPostsByKeywords", "description": "Search Reddit posts by keywords with two response modes. Searches in post titles and selftext. FAST (default, omit responseType or responseType=\"fast\"): Returns up to 300 results directly (use limit param to reduce, e.g. limit=5). Auto API fallback for fresh data. Results include guidance for full mode. PAGING (responseType=\"paging\"): Async paginated results (100/page), returns operationId for polling via checkOperationStatus. Supports pageNumber/tableName for subsequent pages. CSV (responseType=\"csv\"): Async single CSV download, returns operationId, poll for S3 link. CODE EXECUTION: For csv mode, download CSV and use code execution to analyze full dataset. Ideal for: sentiment analysis, subreddit trends, community discussions across thousands of posts. Returns by default: id, title, authorUsername, subredditName, createdAtDate. First searches database, then external API if data is stale or missing. QUERY SYNTAX: Plain keywords (bitcoin, climate change), quoted phrases (\"deep learning\"), boolean expressions (AI AND crypto, bitcoin OR ethereum, politics NOT sports), or parenthesized groups ((startup OR entrepreneur) NOT \"venture capital\"). AND/OR/NOT must have a term on both sides. @handles like @karpathy are supported. Field operators (from:, lang:) are stripped. Forward slashes are treated as spaces (24/7 becomes 24 7). Date filters: OMIT startDate/endDate parameters by default. ONLY pass these if user explicitly requests specific date range (YYYY-MM-DD format). \n IMPORTANT!!!!!: THE CURRENT YEAR IS 2026.\n When user requests relative dates (last week, last month), verify the current date from your \n system context and double-check the calculated dates - models often get the year wrong, searching one year earlier than intended. \nFILTERS: sort (relevance, hot, top, new, comments), time (hour, day, week, month, year, all), subreddit (limit to specific subreddit). FIELDS parameter (optional): Specify to get additional/different fields. Available: Core (id, title, selftext, url, permalink), Author (authorId, authorUsername), Subreddit (subredditName, subredditId), Engagement (score, upvotes, downvotes, upvoteRatio, commentsCount, crosspostsCount), Flags (isSelf, isVideo, over18, spoiler, locked, stickied, archived). This is a safe, read-only tool for analyzing searchable information. ", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "_isTrial": { "type": "boolean" }, "_requestId": { "type": "string" }, "_trialToken": { "type": "string" }, "endDate": { "type": "string" }, "feedback": { "description": "Optional. Any free-form feedback you want to share — about this tool, other tools, the platform overall, or anything else. Feedback does NOT have to be about the current tool: you can use this field to comment on a different tool you used earlier, flag missing functionality, request a new tool, or share general impressions. Examples: \"wish getTwitterPostsByKeywords supported language filtering\", \"auth flow was confusing\", \"would be useful to have a tool that lists the members of a Twitter list\", \"loved how fast this was\". Captured for product feedback; does not affect tool behavior.", "type": "string" }, "fields": { "description": "PERFORMANCE OPTIMIZATION: Specify fields you need. DEFAULT (if omitted): [\"id\", \"title\", \"authorUsername\", \"subredditName\", \"createdAtDate\"]. AVAILABLE FIELDS: Core: id, title, selftext, selftextHtml, url, permalink, postUrl, thumbnail. Author: authorId, authorUsername. Subreddit: subredditName, subredditId. Engagement: score, upvotes, downvotes, upvoteRatio, commentsCount, crosspostsCount. Flags: isSelf, isVideo, isOriginalContent, over18, spoiler, locked, stickied, archived. Meta: linkFlairText, postHint, domain, crosspostParent. Moderation: removal (JSON removal/deletion status), editedAt (ISO datetime of last edit, null if never edited). Timestamps: createdAt, createdAtTimestamp, createdAtDate. EXAMPLES: [\"id\", \"title\", \"score\"] for minimal, [\"title\", \"selftext\", \"score\", \"commentsCount\"] for content analysis.", "items": { "type": "string" }, "type": "array" }, "forceLatest": { "description": "USE SPARINGLY: Force fetching the latest data from the API, bypassing cache checks. Only use when explicitly required (e.g., \"get the latest\", \"most recent\", \"real-time\"). WARNING: Increases latency and API costs. Default: false (uses intelligent caching).", "type": "boolean" }, "limit": { "description": "Max results to return. Fast mode: capped at 300 (default: 300). Paging/CSV modes: caps total exported rows (default: all, max 500K).", "maximum": 500000, "minimum": 1, "type": "number" }, "pageNumber": { "description": "Page number to fetch (1-indexed). Must be provided with tableName to fetch subsequent pages. Omit for first page.", "minimum": 1, "type": "number" }, "pageNumberEnd": { "description": "Optional ending page number for fetching multiple consecutive pages at once (e.g., pageNumber=1, pageNumberEnd=5 fetches pages 1-5). Must be \u003e= pageNumber. Omit to fetch single page only. Requires tableName.", "minimum": 1, "type": "number" }, "query": { "description": "Full-text search of post content. Searches post titles and selftext. EXACT PHRASES: Wrap in double quotes - \"machine learning\" matches that exact phrase. KEYWORDS: Without quotes, matches posts containing any of the words - AI robotics blockchain. BOOLEAN OPERATORS: MUST explicitly use the keywords AND, OR (uppercase or lowercase). NO implicit operators - space between words means OR by default. Examples requiring explicit operators: Use \"deep learning\" AND python (not \"deep learning python\"). Use tensorflow OR pytorch (not \"tensorflow pytorch\"). PARENTHESES: Group terms for precise logic - (AI OR \"artificial intelligence\") AND ethics. Query examples: \"climate change\" | AI OR blockchain | \"neural networks\" AND python | (startup OR entrepreneur)", "maxLength": 250, "minLength": 1, "type": "string" }, "responseType": { "description": "Response mode. \"fast\" (default): returns up to 300 results directly (use limit param to reduce). \"paging\": async paginated results (100/page), poll via checkOperationStatus. \"csv\": async single CSV download, poll for S3 link.", "enum": [ "fast", "paging", "csv" ], "type": "string" }, "sort": { "description": "Sort order for results. Default: relevance.", "enum": [ "relevance", "hot", "top", "new", "comments" ], "type": "string" }, "startDate": { "type": "string" }, "subreddit": { "description": "Filter posts by subreddit name (without r/ prefix). Use this parameter to limit search to a specific subreddit. Example: subreddit=\"wallstreetbets\" finds all posts in r/wallstreetbets.", "type": "string" }, "tableName": { "description": "Cached table name from previous pagination request. Required when fetching pageNumber \u003e 1. Returned in first page response.", "type": "string" }, "time": { "description": "Time filter for results. Default: all.", "enum": [ "hour", "day", "week", "month", "year", "all" ], "type": "string" }, "userPrompt": { "description": "CRITICAL FOR ACCURACY: Include the complete user question to enable query optimization and context-aware filtering. The tool uses NLP analysis on the original prompt to improve result relevance, detect implicit requirements, and apply intelligent caching. Omitting this may result in suboptimal or incomplete results.", "type": "string" } }, "required": [ "query" ], "type": "object" }, "annotations": { "destructiveHint": false, "idempotentHint": false, "openWorldHint": true, "readOnlyHint": true, "title": "Reddit: Get Posts by Keywords" } }, { "name": "getRedditPostWithCommentsById", "description": "Get Reddit post by ID with its comments. Returns both the post data and comments in a single response. FAST (default, omit responseType or responseType=\"fast\"): Returns post and up to 300 comments directly (use limit param to reduce, e.g. limit=5). Auto API fallback for fresh data. Results include guidance for full mode. PAGING (responseType=\"paging\"): Async paginated results (100 comments/page), returns operationId for polling via checkOperationStatus. Supports pageNumber/tableName for subsequent pages. RESPONSE STRUCTURE: Returns { results: { post: {...}, comments: [...] }, count, guidance }. PAGING MODE DETAILS: FIRST CALL: Omit pageNumber and tableName. Creates cached table for comments, returns page 1 with post data and pagination metadata. SUBSEQUENT PAGES: Use tableName from first response with pageNumber (2, 3, etc.) to fetch additional comment pages. Post data is NOT returned on subsequent pages. FIELD SELECTION: Use postFields for post data optimization, commentFields for comment data optimization. First searches database for both post and comments, then external API if data is stale or missing. This is a safe, read-only tool for analyzing searchable information. ", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "_isTrial": { "type": "boolean" }, "_requestId": { "type": "string" }, "_trialToken": { "type": "string" }, "commentFields": { "description": "PERFORMANCE OPTIMIZATION: Specify comment fields you need. DEFAULT (if omitted): [\"id\", \"body\", \"authorUsername\", \"createdAtDate\"]. AVAILABLE FIELDS: Core: id, body, parentPostId, parentId. Author: authorId, authorUsername. Subreddit: postSubredditName, postSubredditId. Engagement: score, upvotes, downvotes, controversiality. Meta: depth, isSubmitter, stickied, collapsed, edited, distinguished. Ranking: rank (position in thread), topLevelRank (position among top-level comments). Moderation: removal (JSON removal/deletion status), collapsedReasonCode, collapsedReason. Timestamps: createdAt, createdAtTimestamp, createdAtDate.", "items": { "type": "string" }, "type": "array" }, "feedback": { "description": "Optional. Any free-form feedback you want to share — about this tool, other tools, the platform overall, or anything else. Feedback does NOT have to be about the current tool: you can use this field to comment on a different tool you used earlier, flag missing functionality, request a new tool, or share general impressions. Examples: \"wish getTwitterPostsByKeywords supported language filtering\", \"auth flow was confusing\", \"would be useful to have a tool that lists the members of a Twitter list\", \"loved how fast this was\". Captured for product feedback; does not affect tool behavior.", "type": "string" }, "forceLatest": { "description": "USE SPARINGLY: Force fetching the latest data from the API, bypassing cache checks. Only use when explicitly required (e.g., \"get the latest\", \"most recent\", \"real-time\"). WARNING: Increases latency and API costs. Default: false (uses intelligent caching).", "type": "boolean" }, "limit": { "description": "Max results to return. Fast mode: capped at 300 (default: 300). Paging/CSV modes: caps total exported rows (default: all, max 500K).", "maximum": 500000, "minimum": 1, "type": "number" }, "pageNumber": { "description": "Page number to fetch (1-indexed). Must be provided with tableName to fetch subsequent pages. Omit for first page.", "minimum": 1, "type": "number" }, "pageNumberEnd": { "description": "Optional ending page number for fetching multiple consecutive pages at once (e.g., pageNumber=1, pageNumberEnd=5 fetches pages 1-5). Must be \u003e= pageNumber. Omit to fetch single page only. Requires tableName.", "minimum": 1, "type": "number" }, "postFields": { "description": "PERFORMANCE OPTIMIZATION: Specify fields you need. DEFAULT (if omitted): [\"id\", \"title\", \"authorUsername\", \"subredditName\", \"createdAtDate\"]. AVAILABLE FIELDS: Core: id, title, selftext, selftextHtml, url, permalink, postUrl, thumbnail. Author: authorId, authorUsername. Subreddit: subredditName, subredditId. Engagement: score, upvotes, downvotes, upvoteRatio, commentsCount, crosspostsCount. Flags: isSelf, isVideo, isOriginalContent, over18, spoiler, locked, stickied, archived. Meta: linkFlairText, postHint, domain, crosspostParent. Moderation: removal (JSON removal/deletion status), editedAt (ISO datetime of last edit, null if never edited). Timestamps: createdAt, createdAtTimestamp, createdAtDate. EXAMPLES: [\"id\", \"title\", \"score\"] for minimal, [\"title\", \"selftext\", \"score\", \"commentsCount\"] for content analysis.", "items": { "type": "string" }, "type": "array" }, "postId": { "description": "Reddit post ID to fetch. Returns the post data along with its comments.", "minLength": 1, "type": "string" }, "responseType": { "description": "Response mode. \"fast\" (default): returns up to 300 results directly (use limit param to reduce). \"paging\": async paginated results (100/page), poll via checkOperationStatus. \"csv\": async single CSV download, poll for S3 link.", "enum": [ "fast", "paging" ], "type": "string" }, "tableName": { "description": "Cached table name from previous pagination request. Required when fetching pageNumber \u003e 1. Returned in first page response.", "type": "string" } }, "required": [ "postId" ], "type": "object" }, "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": true, "readOnlyHint": true, "title": "Reddit: Get Post with Comments by ID" } }, { "name": "getRedditCommentsByKeywords", "description": "Search Reddit comments by keywords. Searches in comment body text. FAST (default, omit responseType or responseType=\"fast\"): Returns up to 300 results directly (use limit param to reduce, e.g. limit=5). Results include guidance for full mode. PAGING (responseType=\"paging\"): Async paginated results (100/page), returns operationId for polling via checkOperationStatus. Supports pageNumber/tableName for subsequent pages. CSV (responseType=\"csv\"): Async single CSV download, returns operationId, poll for S3 link. CODE EXECUTION: For csv mode, download CSV and use code execution to analyze full dataset. Ideal for: sentiment analysis, discussion trends, community opinions across thousands of comments. DATABASE-ONLY: Searches existing database records only. QUERY SYNTAX: Plain keywords (bitcoin, climate change), quoted phrases (\"deep learning\"), boolean expressions (AI AND crypto, bitcoin OR ethereum, politics NOT sports), or parenthesized groups ((startup OR entrepreneur) NOT \"venture capital\"). AND/OR/NOT must have a term on both sides. @handles like @karpathy are supported. Field operators (from:, lang:) are stripped. Forward slashes are treated as spaces (24/7 becomes 24 7). Date filters: OMIT startDate/endDate parameters by default. ONLY pass these if user explicitly requests specific date range (YYYY-MM-DD format). \n IMPORTANT!!!!!: THE CURRENT YEAR IS 2026.\n When user requests relative dates (last week, last month), verify the current date from your \n system context and double-check the calculated dates - models often get the year wrong, searching one year earlier than intended. \nFILTERS: subreddit (limit to specific subreddit without r/ prefix). Optional fields parameter for performance: [\"id\", \"body\", \"authorUsername\", \"postSubredditName\", \"score\", \"createdAtDate\"]. Returns by default: id, body, authorUsername, createdAtDate. This is a safe, read-only tool for analyzing searchable information. ", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "_isTrial": { "type": "boolean" }, "_requestId": { "type": "string" }, "_trialToken": { "type": "string" }, "endDate": { "type": "string" }, "feedback": { "description": "Optional. Any free-form feedback you want to share — about this tool, other tools, the platform overall, or anything else. Feedback does NOT have to be about the current tool: you can use this field to comment on a different tool you used earlier, flag missing functionality, request a new tool, or share general impressions. Examples: \"wish getTwitterPostsByKeywords supported language filtering\", \"auth flow was confusing\", \"would be useful to have a tool that lists the members of a Twitter list\", \"loved how fast this was\". Captured for product feedback; does not affect tool behavior.", "type": "string" }, "fields": { "description": "PERFORMANCE OPTIMIZATION: Specify comment fields you need. DEFAULT (if omitted): [\"id\", \"body\", \"authorUsername\", \"createdAtDate\"]. AVAILABLE FIELDS: Core: id, body, parentPostId, parentId. Author: authorId, authorUsername. Subreddit: postSubredditName, postSubredditId. Engagement: score, upvotes, downvotes, controversiality. Meta: depth, isSubmitter, stickied, collapsed, edited, distinguished. Ranking: rank (position in thread), topLevelRank (position among top-level comments). Moderation: removal (JSON removal/deletion status), collapsedReasonCode, collapsedReason. Timestamps: createdAt, createdAtTimestamp, createdAtDate.", "items": { "type": "string" }, "type": "array" }, "limit": { "description": "Max results to return. Fast mode: capped at 300 (default: 300). Paging/CSV modes: caps total exported rows (default: all, max 500K).", "maximum": 500000, "minimum": 1, "type": "number" }, "pageNumber": { "description": "Page number to fetch (1-indexed). Must be provided with tableName to fetch subsequent pages. Omit for first page.", "minimum": 1, "type": "number" }, "pageNumberEnd": { "description": "Optional ending page number for fetching multiple consecutive pages at once (e.g., pageNumber=1, pageNumberEnd=5 fetches pages 1-5). Must be \u003e= pageNumber. Omit to fetch single page only. Requires tableName.", "minimum": 1, "type": "number" }, "query": { "description": "Full-text search of comment content. Searches comment body text. EXACT PHRASES: Wrap in double quotes - \"machine learning\" matches that exact phrase. KEYWORDS: Without quotes, matches comments containing any of the words - AI robotics blockchain. BOOLEAN OPERATORS: MUST explicitly use the keywords AND, OR (uppercase or lowercase). NO implicit operators - space between words means OR by default. Examples requiring explicit operators: Use \"deep learning\" AND python (not \"deep learning python\"). Use tensorflow OR pytorch (not \"tensorflow pytorch\"). PARENTHESES: Group terms for precise logic - (AI OR \"artificial intelligence\") AND ethics. Query examples: \"climate change\" | AI OR blockchain | \"neural networks\" AND python | (startup OR entrepreneur)", "maxLength": 250, "minLength": 1, "type": "string" }, "responseType": { "description": "Response mode. \"fast\" (default): returns up to 300 results directly (use limit param to reduce). \"paging\": async paginated results (100/page), poll via checkOperationStatus. \"csv\": async single CSV download, poll for S3 link.", "enum": [ "fast", "paging", "csv" ], "type": "string" }, "startDate": { "type": "string" }, "subreddit": { "description": "Filter comments by subreddit name (without r/ prefix). Use this parameter to limit search to comments from a specific subreddit. Example: subreddit=\"wallstreetbets\" finds all comments in r/wallstreetbets.", "type": "string" }, "tableName": { "description": "Cached table name from previous pagination request. Required when fetching pageNumber \u003e 1. Returned in first page response.", "type": "string" } }, "required": [ "query" ], "type": "object" }, "annotations": { "destructiveHint": false, "idempotentHint": false, "openWorldHint": true, "readOnlyHint": true, "title": "Reddit: Get Comments by Keywords" } }, { "name": "getRedditCommentById", "description": "Get a single Reddit comment by its ID. Accepts the bare base36 comment id or the t1_-prefixed form (e.g. \"laz1ytq\" or \"t1_laz1ytq\"), as returned by getRedditPostWithCommentsById and getRedditCommentsByKeywords. First searches database, then fetches from the external API if the comment is missing or stale (\u003e1 week). NOT for searching - use getRedditCommentsByKeywords for keyword search. Optional fields parameter for performance (default: [\"id\", \"body\", \"authorUsername\", \"createdAtDate\"]). Returns: single comment with id, body, author, parent ids, score, and timestamps. This is a safe, read-only tool for analyzing searchable information. ", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "_isTrial": { "type": "boolean" }, "_requestId": { "type": "string" }, "_trialToken": { "type": "string" }, "commentId": { "description": "Reddit comment ID to fetch (bare base36 id or t1_-prefixed, e.g. \"laz1ytq\" or \"t1_laz1ytq\"). Comment ids are returned by getRedditPostWithCommentsById and getRedditCommentsByKeywords.", "minLength": 1, "type": "string" }, "feedback": { "description": "Optional. Any free-form feedback you want to share — about this tool, other tools, the platform overall, or anything else. Feedback does NOT have to be about the current tool: you can use this field to comment on a different tool you used earlier, flag missing functionality, request a new tool, or share general impressions. Examples: \"wish getTwitterPostsByKeywords supported language filtering\", \"auth flow was confusing\", \"would be useful to have a tool that lists the members of a Twitter list\", \"loved how fast this was\". Captured for product feedback; does not affect tool behavior.", "type": "string" }, "fields": { "description": "PERFORMANCE OPTIMIZATION: Specify comment fields you need. DEFAULT (if omitted): [\"id\", \"body\", \"authorUsername\", \"createdAtDate\"]. AVAILABLE FIELDS: Core: id, body, parentPostId, parentId. Author: authorId, authorUsername. Subreddit: postSubredditName, postSubredditId. Engagement: score, upvotes, downvotes, controversiality. Meta: depth, isSubmitter, stickied, collapsed, edited, distinguished. Ranking: rank (position in thread), topLevelRank (position among top-level comments). Moderation: removal (JSON removal/deletion status), collapsedReasonCode, collapsedReason. Timestamps: createdAt, createdAtTimestamp, createdAtDate.", "items": { "type": "string" }, "type": "array" }, "forceLatest": { "description": "USE SPARINGLY: Force fetching the latest data from the API, bypassing cache checks. Only use when explicitly required (e.g., \"get the latest\", \"most recent\", \"real-time\"). WARNING: Increases latency and API costs. Default: false (uses intelligent caching).", "type": "boolean" } }, "required": [ "commentId" ], "type": "object" }, "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": true, "readOnlyHint": true, "title": "Reddit: Get Comment by ID" } }, { "name": "searchRedditSubreddits", "description": "Search Reddit subreddits by keywords using real-time external API. Searches subreddit names and descriptions to find communities. Use for: Discovering communities about topics, finding niche subreddits, exploring Reddit communities. Optional fields parameter for performance (default: [\"id\", \"displayName\", \"title\", \"subscribersCount\"]). Available fields: id, displayName, title, publicDescription, description, subscribersCount, activeUserCount, subredditType, over18, lang, url, subredditUrl, iconImg, bannerImg, headerImg, communityIcon, createdAt. Returns: array of matching subreddits (default 50, max 50) with id, name, description, subscriber count. This is a safe, read-only tool for analyzing searchable information. ", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "_isTrial": { "type": "boolean" }, "_requestId": { "type": "string" }, "_trialToken": { "type": "string" }, "feedback": { "description": "Optional. Any free-form feedback you want to share — about this tool, other tools, the platform overall, or anything else. Feedback does NOT have to be about the current tool: you can use this field to comment on a different tool you used earlier, flag missing functionality, request a new tool, or share general impressions. Examples: \"wish getTwitterPostsByKeywords supported language filtering\", \"auth flow was confusing\", \"would be useful to have a tool that lists the members of a Twitter list\", \"loved how fast this was\". Captured for product feedback; does not affect tool behavior.", "type": "string" }, "fields": { "description": "PERFORMANCE OPTIMIZATION: Specify fields you need. DEFAULT (if omitted): [\"id\", \"displayName\", \"title\", \"subscribersCount\"]. AVAILABLE FIELDS: Core: id, displayName, title, publicDescription, description. Stats: subscribersCount, activeUserCount. Meta: subredditType, submissionType, over18, lang, url, subredditUrl. Images: iconImg, bannerImg, headerImg, communityIcon. Timestamps: createdAt, createdAtTimestamp, createdAtDate. EXAMPLES: [\"id\", \"displayName\", \"subscribersCount\"] for minimal, [\"displayName\", \"publicDescription\", \"subscribersCount\", \"activeUserCount\"] for discovery.", "items": { "type": "string" }, "type": "array" }, "limit": { "description": "Maximum number of subreddits to return. Default: 50, Max: 50.", "maximum": 50, "minimum": 1, "type": "integer" }, "query": { "description": "Search query for Reddit subreddits. Searches subreddit names and descriptions.", "maxLength": 250, "minLength": 1, "type": "string" }, "userPrompt": { "description": "CRITICAL FOR ACCURACY: Include the complete user question to enable query optimization and context-aware filtering. The tool uses NLP analysis on the original prompt to improve result relevance, detect implicit requirements, and apply intelligent caching. Omitting this may result in suboptimal or incomplete results.", "type": "string" } }, "required": [ "query" ], "type": "object" }, "annotations": { "destructiveHint": false, "idempotentHint": false, "openWorldHint": true, "readOnlyHint": true, "title": "Reddit: Search Subreddits" } }, { "name": "getRedditSubredditWithPostsByName", "description": "Get Reddit subreddit by name with its posts. FAST (default, omit responseType or responseType=\"fast\"): Returns subreddit data with up to 300 posts directly (use limit param to reduce). Auto API fallback for fresh data. PAGING (responseType=\"paging\"): Async paginated results (100 posts per page), returns operationId for polling via checkOperationStatus. Supports pageNumber/tableName for subsequent pages. RESPONSE STRUCTURE: Returns { results: { subreddit: {...}, posts: [...] }, pagination: {...} }. FIELD SELECTION: Use subredditFields for subreddit data optimization, postFields for post data optimization. First searches database for both subreddit and posts, then external API if data is stale or missing. This is a safe, read-only tool for analyzing searchable information. ", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "_isTrial": { "type": "boolean" }, "_requestId": { "type": "string" }, "_trialToken": { "type": "string" }, "feedback": { "description": "Optional. Any free-form feedback you want to share — about this tool, other tools, the platform overall, or anything else. Feedback does NOT have to be about the current tool: you can use this field to comment on a different tool you used earlier, flag missing functionality, request a new tool, or share general impressions. Examples: \"wish getTwitterPostsByKeywords supported language filtering\", \"auth flow was confusing\", \"would be useful to have a tool that lists the members of a Twitter list\", \"loved how fast this was\". Captured for product feedback; does not affect tool behavior.", "type": "string" }, "forceLatest": { "description": "USE SPARINGLY: Force fetching the latest data from the API, bypassing cache checks. Only use when explicitly required (e.g., \"get the latest\", \"most recent\", \"real-time\"). WARNING: Increases latency and API costs. Default: false (uses intelligent caching).", "type": "boolean" }, "limit": { "description": "Max results to return. Fast mode: capped at 300 (default: 300). Paging/CSV modes: caps total exported rows (default: all, max 500K).", "maximum": 500000, "minimum": 1, "type": "number" }, "pageNumber": { "description": "Page number to fetch (1-indexed). Must be provided with tableName to fetch subsequent pages. Omit for first page.", "minimum": 1, "type": "number" }, "pageNumberEnd": { "description": "Optional ending page number for fetching multiple consecutive pages at once (e.g., pageNumber=1, pageNumberEnd=5 fetches pages 1-5). Must be \u003e= pageNumber. Omit to fetch single page only. Requires tableName.", "minimum": 1, "type": "number" }, "postFields": { "description": "PERFORMANCE OPTIMIZATION: Specify fields you need. DEFAULT (if omitted): [\"id\", \"title\", \"authorUsername\", \"subredditName\", \"createdAtDate\"]. AVAILABLE FIELDS: Core: id, title, selftext, selftextHtml, url, permalink, postUrl, thumbnail. Author: authorId, authorUsername. Subreddit: subredditName, subredditId. Engagement: score, upvotes, downvotes, upvoteRatio, commentsCount, crosspostsCount. Flags: isSelf, isVideo, isOriginalContent, over18, spoiler, locked, stickied, archived. Meta: linkFlairText, postHint, domain, crosspostParent. Moderation: removal (JSON removal/deletion status), editedAt (ISO datetime of last edit, null if never edited). Timestamps: createdAt, createdAtTimestamp, createdAtDate. EXAMPLES: [\"id\", \"title\", \"score\"] for minimal, [\"title\", \"selftext\", \"score\", \"commentsCount\"] for content analysis.", "items": { "type": "string" }, "type": "array" }, "responseType": { "description": "Response mode. \"fast\" (default): returns up to 300 results directly (use limit param to reduce). \"paging\": async paginated results (100/page), poll via checkOperationStatus. \"csv\": async single CSV download, poll for S3 link.", "enum": [ "fast", "paging" ], "type": "string" }, "subredditFields": { "description": "PERFORMANCE OPTIMIZATION: Specify fields you need. DEFAULT (if omitted): [\"id\", \"displayName\", \"title\", \"subscribersCount\"]. AVAILABLE FIELDS: Core: id, displayName, title, publicDescription, description. Stats: subscribersCount, activeUserCount. Meta: subredditType, submissionType, over18, lang, url, subredditUrl. Images: iconImg, bannerImg, headerImg, communityIcon. Timestamps: createdAt, createdAtTimestamp, createdAtDate. EXAMPLES: [\"id\", \"displayName\", \"subscribersCount\"] for minimal, [\"displayName\", \"publicDescription\", \"subscribersCount\", \"activeUserCount\"] for discovery.", "items": { "type": "string" }, "type": "array" }, "subredditName": { "description": "Reddit subreddit name to fetch (without r/ prefix). Example: \"wallstreetbets\", \"programming\". Returns the subreddit data along with its posts.", "type": "string" }, "tableName": { "description": "Cached table name from previous pagination request. Required when fetching pageNumber \u003e 1. Returned in first page response.", "type": "string" } }, "required": [ "subredditName" ], "type": "object" }, "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": true, "readOnlyHint": true, "title": "Reddit: Get Subreddit with Posts by Name" } }, { "name": "getRedditSubredditsByKeywords", "description": "Search for SUBREDDITS where Reddit posts match keywords. Returns unique, deduplicated subreddit profiles. FAST (default, omit responseType or responseType=\"fast\"): Returns up to 300 results directly (use limit param to reduce). Auto API fallback for fresh data. PAGING (responseType=\"paging\"): Async paginated results (100 per page), returns operationId for polling via checkOperationStatus. Supports pageNumber/tableName for subsequent pages. QUERY SYNTAX: Plain keywords (bitcoin, climate change), quoted phrases (\"deep learning\"), boolean expressions (AI AND crypto, bitcoin OR ethereum, politics NOT sports), or parenthesized groups ((startup OR entrepreneur) NOT \"venture capital\"). AND/OR/NOT must have a term on both sides. @handles like @karpathy are supported. Field operators (from:, lang:) are stripped. Forward slashes are treated as spaces (24/7 becomes 24 7). FILTERS: - startDate/endDate: Filter by post date (YYYY-MM-DD format). OMIT by default, only use if user explicitly requests date range. \n IMPORTANT!!!!!: THE CURRENT YEAR IS 2026.\n When user requests relative dates (last week, last month), verify the current date from your \n system context and double-check the calculated dates - models often get the year wrong, searching one year earlier than intended. \nOptional fields parameter for performance (default: [\"id\", \"displayName\", \"title\", \"subscribersCount\"]). Available fields: id, displayName, title, publicDescription, description, subscribersCount, activeUserCount, and more. AGGREGATE FIELDS (from matching posts) - MUST BE EXPLICITLY REQUESTED IN FIELDS: aggRelevance (relevance score for sorting), relevantPostsCount (count of matching posts per subreddit), relevantPostsUpvotesSum, relevantPostsCommentsCountSum. This is a safe, read-only tool for analyzing searchable information. ", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "_isTrial": { "type": "boolean" }, "_requestId": { "type": "string" }, "_trialToken": { "type": "string" }, "endDate": { "description": "End date filter (YYYY-MM-DD format)", "type": "string" }, "feedback": { "description": "Optional. Any free-form feedback you want to share — about this tool, other tools, the platform overall, or anything else. Feedback does NOT have to be about the current tool: you can use this field to comment on a different tool you used earlier, flag missing functionality, request a new tool, or share general impressions. Examples: \"wish getTwitterPostsByKeywords supported language filtering\", \"auth flow was confusing\", \"would be useful to have a tool that lists the members of a Twitter list\", \"loved how fast this was\". Captured for product feedback; does not affect tool behavior.", "type": "string" }, "fields": { "description": "PERFORMANCE OPTIMIZATION: Specify fields you need. DEFAULT (if omitted): [\"id\", \"displayName\", \"title\", \"subscribersCount\"]. AVAILABLE FIELDS: Core: id, displayName, title, publicDescription, description. Stats: subscribersCount, activeUserCount. Meta: subredditType, submissionType, over18, lang, url, subredditUrl. Images: iconImg, bannerImg, headerImg, communityIcon. Timestamps: createdAt, createdAtTimestamp, createdAtDate. Aggregations (from matching posts): aggRelevance (relevance score), relevantPostsCount (count of matching posts), relevantPostsUpvotesSum, relevantPostsCommentsCountSum. EXAMPLES: [\"id\", \"displayName\", \"subscribersCount\"] for minimal, [\"displayName\", \"subscribersCount\", \"relevantPostsCount\", \"relevantPostsUpvotesSum\"] to include engagement aggregations.", "items": { "type": "string" }, "type": "array" }, "forceLatest": { "description": "USE SPARINGLY: Force fetching the latest data from the API, bypassing cache checks. Only use when explicitly required (e.g., \"get the latest\", \"most recent\", \"real-time\"). WARNING: Increases latency and API costs. Default: false (uses intelligent caching).", "type": "boolean" }, "limit": { "description": "Max results to return. Fast mode: capped at 300 (default: 300). Paging/CSV modes: caps total exported rows (default: all, max 500K).", "maximum": 500000, "minimum": 1, "type": "number" }, "pageNumber": { "description": "Page number to fetch (1-indexed). Must be provided with tableName to fetch subsequent pages. Omit for first page.", "minimum": 1, "type": "number" }, "pageNumberEnd": { "description": "Optional ending page number for fetching multiple consecutive pages at once (e.g., pageNumber=1, pageNumberEnd=5 fetches pages 1-5). Must be \u003e= pageNumber. Omit to fetch single page only. Requires tableName.", "minimum": 1, "type": "number" }, "query": { "description": "Full-text search of Reddit post titles and content to find subreddits where matching posts were made. Searches posts, returns UNIQUE subreddits (deduplicated). EXACT PHRASES: Wrap in double quotes - \"machine learning\" matches that exact phrase. KEYWORDS: Without quotes, matches posts containing any of the words - python tutorial help. BOOLEAN OPERATORS: MUST explicitly use the keywords AND, OR, NOT (uppercase or lowercase). NO implicit operators - space between words means OR by default. Examples requiring explicit operators: Use \"python tutorial\" AND beginner (not \"python tutorial beginner\"). Use programming OR coding (not \"programming coding\"). PARENTHESES: Group terms for precise logic - (python OR javascript) AND (\"web development\" NOT framework). FORBIDDEN: DO NOT use filter operators with colons (from:, to:, since:, until:) - use dedicated parameters instead. Query examples: \"machine learning\" | python help | \"data science\" AND visualization | (gaming OR esports) NOT \"mobile games\"", "maxLength": 250, "minLength": 1, "type": "string" }, "responseType": { "description": "Response mode. \"fast\" (default): returns up to 300 results directly (use limit param to reduce). \"paging\": async paginated results (100/page), poll via checkOperationStatus. \"csv\": async single CSV download, poll for S3 link.", "enum": [ "fast", "paging" ], "type": "string" }, "startDate": { "description": "Start date filter (YYYY-MM-DD format)", "type": "string" }, "tableName": { "description": "Cached table name from previous pagination request. Required when fetching pageNumber \u003e 1. Returned in first page response.", "type": "string" }, "userPrompt": { "description": "CRITICAL FOR ACCURACY: Include the complete user question to enable query optimization and context-aware filtering. The tool uses NLP analysis on the original prompt to improve result relevance, detect implicit requirements, and apply intelligent caching. Omitting this may result in suboptimal or incomplete results.", "type": "string" } }, "required": [ "query" ], "type": "object" }, "annotations": { "destructiveHint": false, "idempotentHint": false, "openWorldHint": true, "readOnlyHint": true, "title": "Reddit: Get Subreddits by Keywords" } }, { "name": "getTiktokUser", "description": "Get Tiktok user profile by ID or username. Use identifierType=\"id\" for numeric user ID, identifierType=\"username\" for username. For username: Use ONLY when you have the precise username. For person names or fuzzy search, use searchTiktokUsers instead. Optional fields parameter for performance (default: [\"id\", \"username\", \"nickname\"]). Available fields: id, username, nickname, signature, isPrivate, isVerified, followerCount, followingCount, likeCount, postCount, avatar, and more. Returns: single user profile. This is a safe, read-only tool for analyzing searchable information. ", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "_isTrial": { "type": "boolean" }, "_requestId": { "type": "string" }, "_trialToken": { "type": "string" }, "feedback": { "description": "Optional. Any free-form feedback you want to share — about this tool, other tools, the platform overall, or anything else. Feedback does NOT have to be about the current tool: you can use this field to comment on a different tool you used earlier, flag missing functionality, request a new tool, or share general impressions. Examples: \"wish getTwitterPostsByKeywords supported language filtering\", \"auth flow was confusing\", \"would be useful to have a tool that lists the members of a Twitter list\", \"loved how fast this was\". Captured for product feedback; does not affect tool behavior.", "type": "string" }, "fields": { "description": "PERFORMANCE OPTIMIZATION: Specify fields you need. DEFAULT (if omitted): [\"id\", \"username\", \"nickname\"]. AVAILABLE FIELDS: Core: id, username, nickname, signature, secUid, avatar, isPrivate, isVerified. Engagement: followerCount, followingCount, likeCount, postCount. Meta: language, region, createdAt, usernameModifyTime. EXAMPLES: [\"id\", \"username\"] for minimal, [\"username\", \"nickname\", \"followerCount\"] for basic info.", "items": { "type": "string" }, "type": "array" }, "forceLatest": { "description": "USE SPARINGLY: Force fetching the latest data from the API, bypassing cache checks. Only use when explicitly required (e.g., \"get the latest\", \"most recent\", \"real-time\"). WARNING: Increases latency and API costs. Default: false (uses intelligent caching).", "type": "boolean" }, "identifier": { "description": "User ID (numeric) or username depending on identifierType.", "minLength": 1, "type": "string" }, "identifierType": { "description": "Type of identifier provided. Use \"id\" for numeric user ID, \"username\" for username.", "enum": [ "id", "username" ], "type": "string" }, "userPrompt": { "description": "CRITICAL FOR ACCURACY: Include the complete user question to enable query optimization and context-aware filtering. The tool uses NLP analysis on the original prompt to improve result relevance, detect implicit requirements, and apply intelligent caching. Omitting this may result in suboptimal or incomplete results.", "type": "string" } }, "required": [ "identifier", "identifierType" ], "type": "object" }, "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": true, "readOnlyHint": true, "title": "Tiktok: Get User" } }, { "name": "searchTiktokUsers", "description": "Search Tiktok users by name or username via external API. Use for: Name-based search, finding multiple candidates, fuzzy matching, discovering users. NOT for: Exact username lookup (use getTiktokUser when username is certain). Optional fields parameter for performance (default: [\"id\", \"username\", \"nickname\"]). Returns: array of matching users (default 10, max 10). This is a safe, read-only tool for analyzing searchable information. ", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "_isTrial": { "type": "boolean" }, "_requestId": { "type": "string" }, "_trialToken": { "type": "string" }, "feedback": { "description": "Optional. Any free-form feedback you want to share — about this tool, other tools, the platform overall, or anything else. Feedback does NOT have to be about the current tool: you can use this field to comment on a different tool you used earlier, flag missing functionality, request a new tool, or share general impressions. Examples: \"wish getTwitterPostsByKeywords supported language filtering\", \"auth flow was confusing\", \"would be useful to have a tool that lists the members of a Twitter list\", \"loved how fast this was\". Captured for product feedback; does not affect tool behavior.", "type": "string" }, "fields": { "description": "PERFORMANCE OPTIMIZATION: Specify fields you need. DEFAULT (if omitted): [\"id\", \"username\", \"nickname\"]. AVAILABLE FIELDS: Core: id, username, nickname, signature, secUid, avatar, isPrivate, isVerified. Engagement: followerCount, followingCount, likeCount, postCount. Meta: language, region, createdAt, usernameModifyTime. EXAMPLES: [\"id\", \"username\"] for minimal, [\"username\", \"nickname\", \"followerCount\"] for basic info.", "items": { "type": "string" }, "type": "array" }, "limit": { "description": "Maximum number of users to return. Default: 10, Max: 10.", "maximum": 10, "minimum": 1, "type": "number" }, "name": { "description": "Search query for Tiktok users. Supports partial name or username matching.", "minLength": 1, "type": "string" }, "userPrompt": { "description": "CRITICAL FOR ACCURACY: Include the complete user question to enable query optimization and context-aware filtering. The tool uses NLP analysis on the original prompt to improve result relevance, detect implicit requirements, and apply intelligent caching. Omitting this may result in suboptimal or incomplete results.", "type": "string" } }, "required": [ "name" ], "type": "object" }, "annotations": { "destructiveHint": false, "idempotentHint": false, "openWorldHint": true, "readOnlyHint": true, "title": "Tiktok: Search Users" } }, { "name": "getTiktokUsersByKeywords", "description": "Search for USERS who authored Tiktok posts matching keywords. USE CASE: Find users who have posted content about specific topics. Returns unique, deduplicated user profiles. RESPONSE MODES (responseType parameter): \"fast\" (DEFAULT): Returns up to 300 results directly in one call. Use limit param to reduce. Best for quick lookups. \"paging\": Async paginated results (100/page). Returns operation ID - call checkOperationStatus to get results. Use pageNumber/tableName for subsequent pages. \"csv\": Async CSV export. Returns dataDumpExportOperationId - call checkOperationStatus to get S3 download link. Best for bulk export. PAGING MODE DETAILS: FIRST CALL: Omit pageNumber and tableName. Creates cached table, returns page 1 with pagination metadata (tableName, totalPages, totalRows). SUBSEQUENT PAGES: Use tableName from first response with pageNumber (2, 3, etc.). BULK FETCH: Use pageNumberEnd with pageNumber and tableName for multiple consecutive pages. QUERY SYNTAX: Plain keywords (bitcoin, climate change), quoted phrases (\"deep learning\"), boolean expressions (AI AND crypto, bitcoin OR ethereum, politics NOT sports), or parenthesized groups ((startup OR entrepreneur) NOT \"venture capital\"). AND/OR/NOT must have a term on both sides. @handles like @karpathy are supported. Field operators (from:, lang:) are stripped. Forward slashes are treated as spaces (24/7 becomes 24 7). FILTERS: startDate/endDate (YYYY-MM-DD format). OMIT by default. \n IMPORTANT!!!!!: THE CURRENT YEAR IS 2026.\n When user requests relative dates (last week, last month), verify the current date from your \n system context and double-check the calculated dates - models often get the year wrong, searching one year earlier than intended. \nOptional fields parameter for performance (default: [\"id\", \"username\", \"nickname\"]). AGGREGATE FIELDS (from matching posts) - MUST BE EXPLICITLY REQUESTED IN FIELDS: aggRelevance, relevantPostsCount, relevantPostsLikesSum, relevantPostsCommentsSum, relevantPostsPlaysSum, relevantPostsForwardsSum. This is a safe, read-only tool for analyzing searchable information. ", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "_isTrial": { "type": "boolean" }, "_requestId": { "type": "string" }, "_trialToken": { "type": "string" }, "endDate": { "type": "string" }, "feedback": { "description": "Optional. Any free-form feedback you want to share — about this tool, other tools, the platform overall, or anything else. Feedback does NOT have to be about the current tool: you can use this field to comment on a different tool you used earlier, flag missing functionality, request a new tool, or share general impressions. Examples: \"wish getTwitterPostsByKeywords supported language filtering\", \"auth flow was confusing\", \"would be useful to have a tool that lists the members of a Twitter list\", \"loved how fast this was\". Captured for product feedback; does not affect tool behavior.", "type": "string" }, "fields": { "description": "PERFORMANCE OPTIMIZATION: Specify fields you need. DEFAULT (if omitted): [\"id\", \"username\", \"nickname\"]. AVAILABLE FIELDS: Core: id, username, nickname, signature, secUid, avatar, isPrivate, isVerified. Engagement: followerCount, followingCount, likeCount, postCount. Meta: language, region, createdAt, usernameModifyTime. Aggregations (from matching posts): aggRelevance, relevantPostsCount, relevantPostsLikesSum, relevantPostsCommentsSum, relevantPostsPlaysSum, relevantPostsForwardsSum. EXAMPLES: [\"id\", \"username\"] for minimal, [\"username\", \"nickname\", \"followerCount\", \"relevantPostsCount\"] to include engagement aggregations.", "items": { "type": "string" }, "type": "array" }, "forceLatest": { "description": "USE SPARINGLY: Force fetching the latest data from the API, bypassing cache checks. Only use when explicitly required (e.g., \"get the latest\", \"most recent\", \"real-time\"). WARNING: Increases latency and API costs. Default: false (uses intelligent caching).", "type": "boolean" }, "limit": { "description": "Max results to return. Fast mode: capped at 300 (default: 300). Paging/CSV modes: caps total exported rows (default: all, max 500K).", "maximum": 500000, "minimum": 1, "type": "number" }, "pageNumber": { "description": "Page number to fetch (1-indexed). Must be provided with tableName to fetch subsequent pages. Omit for first page.", "minimum": 1, "type": "number" }, "pageNumberEnd": { "description": "Optional ending page number for fetching multiple consecutive pages at once (e.g., pageNumber=1, pageNumberEnd=5 fetches pages 1-5). Must be \u003e= pageNumber. Omit to fetch single page only. Requires tableName.", "minimum": 1, "type": "number" }, "query": { "description": "Full-text search of Tiktok post descriptions to find users who authored matching posts. Searches posts, returns UNIQUE user authors (deduplicated). EXACT PHRASES: Wrap in double quotes - \"sustainable fashion\" matches that exact phrase. KEYWORDS: Without quotes, matches posts containing any of the words. BOOLEAN OPERATORS: Use AND, OR, NOT explicitly. PARENTHESES: Group terms - (travel OR adventure) AND \"sustainable living\". FORBIDDEN: DO NOT use filter operators with colons. Query examples: \"climate change\" | fashion OR beauty | \"digital nomad\" AND remote", "maxLength": 250, "minLength": 1, "type": "string" }, "responseType": { "description": "Response mode. \"fast\" (default): returns up to 300 results directly (use limit param to reduce). \"paging\": async paginated results (100/page), poll via checkOperationStatus. \"csv\": async single CSV download, poll for S3 link.", "enum": [ "fast", "paging", "csv" ], "type": "string" }, "startDate": { "type": "string" }, "tableName": { "description": "Cached table name from previous pagination request. Required when fetching pageNumber \u003e 1. Returned in first page response.", "type": "string" }, "userPrompt": { "description": "CRITICAL FOR ACCURACY: Include the complete user question to enable query optimization and context-aware filtering. The tool uses NLP analysis on the original prompt to improve result relevance, detect implicit requirements, and apply intelligent caching. Omitting this may result in suboptimal or incomplete results.", "type": "string" } }, "required": [ "query" ], "type": "object" }, "annotations": { "destructiveHint": false, "idempotentHint": false, "openWorldHint": true, "readOnlyHint": true, "title": "Tiktok: Get Users by Keywords" } }, { "name": "getTiktokUsersByHashtags", "description": "Search for USERS who authored Tiktok posts tagged with specific hashtags. USE CASE: Find users who have posted content tagged with one or more hashtags. Returns unique, deduplicated user profiles. Pass hashtags as an array of bare alphanumeric strings - do NOT include leading \"#\". OR semantics: matches users who posted content tagged with ANY of the listed hashtags. RESPONSE MODES (responseType parameter): \"fast\" (DEFAULT): Returns up to 300 results directly in one call. Use limit param to reduce. Best for quick lookups. \"paging\": Async paginated results (100/page). Returns operation ID - call checkOperationStatus to get results. Use pageNumber/tableName for subsequent pages. \"csv\": Async CSV export. Returns dataDumpExportOperationId - call checkOperationStatus to get S3 download link. Best for bulk export. NOT for keyword/phrase search in descriptions - use getTiktokUsersByKeywords instead. FILTERS: startDate/endDate (YYYY-MM-DD format). OMIT by default. \n IMPORTANT!!!!!: THE CURRENT YEAR IS 2026.\n When user requests relative dates (last week, last month), verify the current date from your \n system context and double-check the calculated dates - models often get the year wrong, searching one year earlier than intended. \nOptional fields parameter for performance (default: [\"id\", \"username\", \"nickname\"]). AGGREGATE FIELDS (from matching posts) - MUST BE EXPLICITLY REQUESTED IN FIELDS: aggRelevance, relevantPostsCount, relevantPostsLikesSum, relevantPostsCommentsSum, relevantPostsPlaysSum, relevantPostsForwardsSum. This is a safe, read-only tool for analyzing searchable information. ", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "_isTrial": { "type": "boolean" }, "_requestId": { "type": "string" }, "_trialToken": { "type": "string" }, "endDate": { "type": "string" }, "feedback": { "description": "Optional. Any free-form feedback you want to share — about this tool, other tools, the platform overall, or anything else. Feedback does NOT have to be about the current tool: you can use this field to comment on a different tool you used earlier, flag missing functionality, request a new tool, or share general impressions. Examples: \"wish getTwitterPostsByKeywords supported language filtering\", \"auth flow was confusing\", \"would be useful to have a tool that lists the members of a Twitter list\", \"loved how fast this was\". Captured for product feedback; does not affect tool behavior.", "type": "string" }, "fields": { "description": "PERFORMANCE OPTIMIZATION: Specify fields you need. DEFAULT (if omitted): [\"id\", \"username\", \"nickname\"]. AVAILABLE FIELDS: Core: id, username, nickname, signature, secUid, avatar, isPrivate, isVerified. Engagement: followerCount, followingCount, likeCount, postCount. Meta: language, region, createdAt, usernameModifyTime. Aggregations (from matching posts): aggRelevance, relevantPostsCount, relevantPostsLikesSum, relevantPostsCommentsSum, relevantPostsPlaysSum, relevantPostsForwardsSum. EXAMPLES: [\"id\", \"username\"] for minimal, [\"username\", \"nickname\", \"followerCount\", \"relevantPostsCount\"] to include engagement aggregations.", "items": { "type": "string" }, "type": "array" }, "forceLatest": { "description": "USE SPARINGLY: Force fetching the latest data from the API, bypassing cache checks. Only use when explicitly required (e.g., \"get the latest\", \"most recent\", \"real-time\"). WARNING: Increases latency and API costs. Default: false (uses intelligent caching).", "type": "boolean" }, "hashtags": { "description": "Array of hashtags to search for (1-5 per request). OR semantics: matches users who posted content containing ANY of the listed hashtags. Bare alphanumeric/underscore only - do NOT include leading \"#\". Examples: [\"dance\", \"fyp\"] | [\"cooking\"] | [\"sustainable_fashion\"].", "items": { "pattern": "^[A-Za-z0-9_]{1,500}$", "type": "string" }, "maxItems": 5, "minItems": 1, "type": "array" }, "limit": { "description": "Max results to return. Fast mode: capped at 300 (default: 300). Paging/CSV modes: caps total exported rows (default: all, max 500K).", "maximum": 500000, "minimum": 1, "type": "number" }, "pageNumber": { "description": "Page number to fetch (1-indexed). Must be provided with tableName to fetch subsequent pages. Omit for first page.", "minimum": 1, "type": "number" }, "pageNumberEnd": { "description": "Optional ending page number for fetching multiple consecutive pages at once (e.g., pageNumber=1, pageNumberEnd=5 fetches pages 1-5). Must be \u003e= pageNumber. Omit to fetch single page only. Requires tableName.", "minimum": 1, "type": "number" }, "responseType": { "description": "Response mode. \"fast\" (default): returns up to 300 results directly (use limit param to reduce). \"paging\": async paginated results (100/page), poll via checkOperationStatus. \"csv\": async single CSV download, poll for S3 link.", "enum": [ "fast", "paging", "csv" ], "type": "string" }, "startDate": { "type": "string" }, "tableName": { "description": "Cached table name from previous pagination request. Required when fetching pageNumber \u003e 1. Returned in first page response.", "type": "string" }, "userPrompt": { "description": "CRITICAL FOR ACCURACY: Include the complete user question to enable query optimization and context-aware filtering. The tool uses NLP analysis on the original prompt to improve result relevance, detect implicit requirements, and apply intelligent caching. Omitting this may result in suboptimal or incomplete results.", "type": "string" } }, "required": [ "hashtags" ], "type": "object" }, "annotations": { "destructiveHint": false, "idempotentHint": false, "openWorldHint": true, "readOnlyHint": true, "title": "Tiktok: Get Users by Hashtags" } }, { "name": "getTiktokPostsByIds", "description": "Get multiple Tiktok posts by IDs (1-100 IDs per request). Returns results directly. First searches database, then external API for missing/stale data. Optional fields parameter for performance: [\"id\", \"description\", \"likeCount\"]. Returns: results array with id, description, userId, username, createdAtDate, engagement metrics. This is a safe, read-only tool for analyzing searchable information. ", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "_isTrial": { "type": "boolean" }, "_requestId": { "type": "string" }, "_trialToken": { "type": "string" }, "feedback": { "description": "Optional. Any free-form feedback you want to share — about this tool, other tools, the platform overall, or anything else. Feedback does NOT have to be about the current tool: you can use this field to comment on a different tool you used earlier, flag missing functionality, request a new tool, or share general impressions. Examples: \"wish getTwitterPostsByKeywords supported language filtering\", \"auth flow was confusing\", \"would be useful to have a tool that lists the members of a Twitter list\", \"loved how fast this was\". Captured for product feedback; does not affect tool behavior.", "type": "string" }, "fields": { "description": "PERFORMANCE OPTIMIZATION: Specify fields you need. DEFAULT (if omitted): [\"id\", \"description\", \"username\", \"createdAtDate\"]. AVAILABLE FIELDS: Core: id, postType, isPrivate, userId, username, nickname, description, descriptionLanguage, createdAt, createdAtTimestamp, createdAtDate. Engagement: collectCount, commentCount, likeCount, downloadCount, forwardCount, playCount. Media: videoThumbnail, videoUrl (array of video URLs), duration (video length in seconds). Content: hashtags (array of hashtag strings). EXAMPLES: [\"id\", \"description\"] for minimal, [\"id\", \"description\", \"username\", \"createdAtDate\", \"likeCount\", \"playCount\"] for basic analysis, [\"id\", \"description\", \"hashtags\", \"duration\", \"videoUrl\"] for video content analysis.", "items": { "type": "string" }, "type": "array" }, "forceLatest": { "description": "USE SPARINGLY: Force fetching the latest data from the API, bypassing cache checks. Only use when explicitly required (e.g., \"get the latest\", \"most recent\", \"real-time\"). WARNING: Increases latency and API costs. Default: false (uses intelligent caching).", "type": "boolean" }, "postIds": { "description": "Array of Tiktok post IDs to fetch (1-100 IDs). Returns only found posts, omitting not-found IDs.", "items": { "pattern": "^\\d{1,50}$", "type": "string" }, "maxItems": 100, "minItems": 1, "type": "array" }, "userPrompt": { "description": "CRITICAL FOR ACCURACY: Include the complete user question to enable query optimization and context-aware filtering.", "type": "string" } }, "required": [ "postIds" ], "type": "object" }, "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": true, "readOnlyHint": true, "title": "Tiktok: Get Posts by IDs" } }, { "name": "getTiktokPostsByUser", "description": "Get posts from Tiktok user by ID or username with three response modes. Use identifierType=\"id\" for numeric user ID, identifierType=\"username\" for username. FAST (default, omit responseType or responseType=\"fast\"): Returns up to 300 results directly (use limit param to reduce, e.g. limit=5). Auto API fallback for fresh data. Results include guidance for full mode. PAGING (responseType=\"paging\"): Async paginated results (100/page), returns operationId for polling via checkOperationStatus. Supports pageNumber/tableName for subsequent pages. CSV (responseType=\"csv\"): Async single CSV download, returns operationId, poll for S3 link. CODE EXECUTION: For csv mode, download CSV and use code execution to analyze full dataset. Ideal for: engagement analysis, content trends, viral video detection, processing thousands of posts. Returns by default: id, description, username, createdAtDate. First searches database, then external API if data is stale or missing. Date filters: OMIT startDate/endDate parameters by default to retrieve all posts. ONLY pass these if user explicitly requests specific date range (YYYY-MM-DD format). \n IMPORTANT!!!!!: THE CURRENT YEAR IS 2026.\n When user requests relative dates (last week, last month), verify the current date from your \n system context and double-check the calculated dates - models often get the year wrong, searching one year earlier than intended. \nFIELDS parameter (optional): Specify to get additional/different fields. Available: Core (id, description, userId, username, nickname, createdAtDate), Engagement (likeCount, commentCount, playCount, forwardCount, collectCount, downloadCount), Media (videoThumbnail, videoUrl, duration, postType), Content (hashtags, transcriptsJson). This is a safe, read-only tool for analyzing searchable information. ", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "_isTrial": { "type": "boolean" }, "_requestId": { "type": "string" }, "_trialToken": { "type": "string" }, "endDate": { "type": "string" }, "feedback": { "description": "Optional. Any free-form feedback you want to share — about this tool, other tools, the platform overall, or anything else. Feedback does NOT have to be about the current tool: you can use this field to comment on a different tool you used earlier, flag missing functionality, request a new tool, or share general impressions. Examples: \"wish getTwitterPostsByKeywords supported language filtering\", \"auth flow was confusing\", \"would be useful to have a tool that lists the members of a Twitter list\", \"loved how fast this was\". Captured for product feedback; does not affect tool behavior.", "type": "string" }, "fields": { "description": "PERFORMANCE OPTIMIZATION: Specify fields you need. DEFAULT (if omitted): [\"id\", \"description\", \"username\", \"createdAtDate\"]. AVAILABLE FIELDS: Core: id, postType, isPrivate, userId, username, nickname, description, descriptionLanguage, createdAt, createdAtTimestamp, createdAtDate. Engagement: collectCount, commentCount, likeCount, downloadCount, forwardCount, playCount. Media: videoThumbnail, videoUrl (array of video URLs), duration (video length in seconds). Content: hashtags (array of hashtag strings). EXAMPLES: [\"id\", \"description\"] for minimal, [\"id\", \"description\", \"username\", \"createdAtDate\", \"likeCount\", \"playCount\"] for basic analysis, [\"id\", \"description\", \"hashtags\", \"duration\", \"videoUrl\"] for video content analysis.", "items": { "type": "string" }, "type": "array" }, "forceLatest": { "description": "USE SPARINGLY: Force fetching the latest data from the API, bypassing cache checks. Only use when explicitly required (e.g., \"get the latest\", \"most recent\", \"real-time\"). WARNING: Increases latency and API costs. Default: false (uses intelligent caching).", "type": "boolean" }, "identifier": { "description": "User ID (numeric) or username depending on identifierType.", "minLength": 1, "type": "string" }, "identifierType": { "description": "Type of identifier provided. Use \"id\" for numeric user ID, \"username\" for username.", "enum": [ "id", "username" ], "type": "string" }, "limit": { "description": "Max results to return. Fast mode: capped at 300 (default: 300). Paging/CSV modes: caps total exported rows (default: all, max 500K).", "maximum": 500000, "minimum": 1, "type": "number" }, "pageNumber": { "description": "Page number to fetch (1-indexed). Must be provided with tableName to fetch subsequent pages. Omit for first page.", "minimum": 1, "type": "number" }, "pageNumberEnd": { "description": "Optional ending page number for fetching multiple consecutive pages at once. Must be \u003e= pageNumber. Requires tableName.", "minimum": 1, "type": "number" }, "responseType": { "description": "Response mode. \"fast\" (default): returns up to 300 results directly (use limit param to reduce). \"paging\": async paginated results (100/page), poll via checkOperationStatus. \"csv\": async single CSV download, poll for S3 link.", "enum": [ "fast", "paging", "csv" ], "type": "string" }, "startDate": { "type": "string" }, "tableName": { "description": "Cached table name from previous pagination request. Required when fetching pageNumber \u003e 1. Returned in first page response.", "type": "string" }, "userPrompt": { "description": "CRITICAL FOR ACCURACY: Include the complete user question to enable query optimization and context-aware filtering.", "type": "string" } }, "required": [ "identifier", "identifierType" ], "type": "object" }, "annotations": { "destructiveHint": false, "idempotentHint": false, "openWorldHint": true, "readOnlyHint": true, "title": "Tiktok: Get Posts by User" } }, { "name": "getTiktokPostsByKeywords", "description": "Search Tiktok posts by keywords with three response modes. Searches post descriptions and video transcripts. FAST (default, omit responseType or responseType=\"fast\"): Returns up to 300 results directly (use limit param to reduce, e.g. limit=5). PAGING (responseType=\"paging\"): Async paginated results (100/page), returns operationId for polling via checkOperationStatus. Supports pageNumber/tableName for subsequent pages. CSV (responseType=\"csv\"): Async single CSV download, returns operationId, poll for S3 link. CODE EXECUTION: For csv mode, download CSV and use code execution to analyze full dataset. Ideal for: trend analysis, hashtag tracking, viral content discovery across Tiktok. Returns by default: id, description, username, createdAtDate. NOT for URL lookups or post ID lookups - use getTiktokPostsByIds instead. QUERY SYNTAX: Plain keywords (bitcoin, climate change), quoted phrases (\"deep learning\"), boolean expressions (AI AND crypto, bitcoin OR ethereum, politics NOT sports), or parenthesized groups ((startup OR entrepreneur) NOT \"venture capital\"). AND/OR/NOT must have a term on both sides. @handles like @karpathy are supported. Field operators (from:, lang:) are stripped. Forward slashes are treated as spaces (24/7 becomes 24 7). Date filters: OMIT startDate/endDate parameters by default to retrieve all posts. ONLY pass these if user explicitly requests specific date range (YYYY-MM-DD format). \n IMPORTANT!!!!!: THE CURRENT YEAR IS 2026.\n When user requests relative dates (last week, last month), verify the current date from your \n system context and double-check the calculated dates - models often get the year wrong, searching one year earlier than intended. \nFIELDS parameter (optional): Specify to get additional/different fields. Available: Core (id, description, userId, username, nickname, createdAtDate), Engagement (likeCount, commentCount, playCount, forwardCount, collectCount, downloadCount), Media (videoThumbnail, videoUrl, duration, postType), Content (hashtags, transcriptsJson). This is a safe, read-only tool for analyzing searchable information. ", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "_isTrial": { "type": "boolean" }, "_requestId": { "type": "string" }, "_trialToken": { "type": "string" }, "endDate": { "type": "string" }, "feedback": { "description": "Optional. Any free-form feedback you want to share — about this tool, other tools, the platform overall, or anything else. Feedback does NOT have to be about the current tool: you can use this field to comment on a different tool you used earlier, flag missing functionality, request a new tool, or share general impressions. Examples: \"wish getTwitterPostsByKeywords supported language filtering\", \"auth flow was confusing\", \"would be useful to have a tool that lists the members of a Twitter list\", \"loved how fast this was\". Captured for product feedback; does not affect tool behavior.", "type": "string" }, "fields": { "description": "PERFORMANCE OPTIMIZATION: Specify fields you need. DEFAULT (if omitted): [\"id\", \"description\", \"username\", \"createdAtDate\"]. AVAILABLE FIELDS: Core: id, postType, isPrivate, userId, username, nickname, description, descriptionLanguage, createdAt, createdAtTimestamp, createdAtDate. Engagement: collectCount, commentCount, likeCount, downloadCount, forwardCount, playCount. Media: videoThumbnail, videoUrl (array of video URLs), duration (video length in seconds). Content: hashtags (array of hashtag strings). EXAMPLES: [\"id\", \"description\"] for minimal, [\"id\", \"description\", \"username\", \"createdAtDate\", \"likeCount\", \"playCount\"] for basic analysis, [\"id\", \"description\", \"hashtags\", \"duration\", \"videoUrl\"] for video content analysis.", "items": { "type": "string" }, "type": "array" }, "forceLatest": { "description": "USE SPARINGLY: Force fetching the latest data from the API, bypassing cache checks. Only use when explicitly required (e.g., \"get the latest\", \"most recent\", \"real-time\"). WARNING: Increases latency and API costs. Default: false (uses intelligent caching).", "type": "boolean" }, "limit": { "description": "Max results to return. Fast mode: capped at 300 (default: 300). Paging/CSV modes: caps total exported rows (default: all, max 500K).", "maximum": 500000, "minimum": 1, "type": "number" }, "pageNumber": { "description": "Page number to fetch (1-indexed). Must be provided with tableName to fetch subsequent pages. Omit for first page.", "minimum": 1, "type": "number" }, "pageNumberEnd": { "description": "Optional ending page number for fetching multiple consecutive pages at once. Must be \u003e= pageNumber. Requires tableName.", "minimum": 1, "type": "number" }, "query": { "description": "Plain text keywords or phrases to search in post descriptions. Use double quotes for exact phrases. Do NOT pass URLs or post IDs. Examples: \"dance challenge\", cooking OR recipe, \"sunset\" AND beach", "maxLength": 250, "minLength": 1, "type": "string" }, "responseType": { "description": "Response mode. \"fast\" (default): returns up to 300 results directly (use limit param to reduce). \"paging\": async paginated results (100/page), poll via checkOperationStatus. \"csv\": async single CSV download, poll for S3 link.", "enum": [ "fast", "paging", "csv" ], "type": "string" }, "startDate": { "type": "string" }, "tableName": { "description": "Cached table name from previous pagination request. Required when fetching pageNumber \u003e 1. Returned in first page response.", "type": "string" }, "userPrompt": { "description": "CRITICAL FOR ACCURACY: Include the complete user question to enable query optimization and context-aware filtering.", "type": "string" } }, "required": [ "query" ], "type": "object" }, "annotations": { "destructiveHint": false, "idempotentHint": false, "openWorldHint": true, "readOnlyHint": true, "title": "Tiktok: Get Posts by Keywords" } }, { "name": "getTiktokPostsByHashtags", "description": "Search Tiktok posts by hashtags with three response modes. Searches the hashtags column directly (NOT post descriptions). Pass hashtags as an array of bare alphanumeric strings - do NOT include leading \"#\". OR semantics: matches posts containing ANY of the listed hashtags. FAST (default, omit responseType or responseType=\"fast\"): Returns up to 300 results directly (use limit param to reduce, e.g. limit=5). PAGING (responseType=\"paging\"): Async paginated results (100/page), returns operationId for polling via checkOperationStatus. Supports pageNumber/tableName for subsequent pages. CSV (responseType=\"csv\"): Async single CSV download, returns operationId, poll for S3 link. CODE EXECUTION: For csv mode, download CSV and use code execution to analyze full dataset. Ideal for: hashtag trend analysis, viral hashtag tracking, cross-hashtag content discovery. Returns by default: id, description, username, createdAtDate. NOT for keyword/phrase search in descriptions - use getTiktokPostsByKeywords instead. NOT for URL or post ID lookups - use getTiktokPostsByIds instead. Date filters: OMIT startDate/endDate parameters by default to retrieve all posts. ONLY pass these if user explicitly requests specific date range (YYYY-MM-DD format). \n IMPORTANT!!!!!: THE CURRENT YEAR IS 2026.\n When user requests relative dates (last week, last month), verify the current date from your \n system context and double-check the calculated dates - models often get the year wrong, searching one year earlier than intended. \nFIELDS parameter (optional): Specify to get additional/different fields. Available: Core (id, description, userId, username, nickname, createdAtDate), Engagement (likeCount, commentCount, playCount, forwardCount, collectCount, downloadCount), Media (videoThumbnail, videoUrl, duration, postType), Content (hashtags, transcriptsJson). This is a safe, read-only tool for analyzing searchable information. ", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "_isTrial": { "type": "boolean" }, "_requestId": { "type": "string" }, "_trialToken": { "type": "string" }, "endDate": { "type": "string" }, "feedback": { "description": "Optional. Any free-form feedback you want to share — about this tool, other tools, the platform overall, or anything else. Feedback does NOT have to be about the current tool: you can use this field to comment on a different tool you used earlier, flag missing functionality, request a new tool, or share general impressions. Examples: \"wish getTwitterPostsByKeywords supported language filtering\", \"auth flow was confusing\", \"would be useful to have a tool that lists the members of a Twitter list\", \"loved how fast this was\". Captured for product feedback; does not affect tool behavior.", "type": "string" }, "fields": { "description": "PERFORMANCE OPTIMIZATION: Specify fields you need. DEFAULT (if omitted): [\"id\", \"description\", \"username\", \"createdAtDate\"]. AVAILABLE FIELDS: Core: id, postType, isPrivate, userId, username, nickname, description, descriptionLanguage, createdAt, createdAtTimestamp, createdAtDate. Engagement: collectCount, commentCount, likeCount, downloadCount, forwardCount, playCount. Media: videoThumbnail, videoUrl (array of video URLs), duration (video length in seconds). Content: hashtags (array of hashtag strings). EXAMPLES: [\"id\", \"description\"] for minimal, [\"id\", \"description\", \"username\", \"createdAtDate\", \"likeCount\", \"playCount\"] for basic analysis, [\"id\", \"description\", \"hashtags\", \"duration\", \"videoUrl\"] for video content analysis.", "items": { "type": "string" }, "type": "array" }, "forceLatest": { "description": "USE SPARINGLY: Force fetching the latest data from the API, bypassing cache checks. Only use when explicitly required (e.g., \"get the latest\", \"most recent\", \"real-time\"). WARNING: Increases latency and API costs. Default: false (uses intelligent caching).", "type": "boolean" }, "hashtags": { "description": "Array of hashtags to search for (1-5 per request). OR semantics: matches posts containing ANY of the listed hashtags. Bare alphanumeric/underscore only - do NOT include leading \"#\". Examples: [\"dance\", \"fyp\", \"viral\"] | [\"cooking\"] | [\"sustainable_fashion\"].", "items": { "pattern": "^[A-Za-z0-9_]{1,500}$", "type": "string" }, "maxItems": 5, "minItems": 1, "type": "array" }, "limit": { "description": "Max results to return. Fast mode: capped at 300 (default: 300). Paging/CSV modes: caps total exported rows (default: all, max 500K).", "maximum": 500000, "minimum": 1, "type": "number" }, "pageNumber": { "description": "Page number to fetch (1-indexed). Must be provided with tableName to fetch subsequent pages. Omit for first page.", "minimum": 1, "type": "number" }, "pageNumberEnd": { "description": "Optional ending page number for fetching multiple consecutive pages at once. Must be \u003e= pageNumber. Requires tableName.", "minimum": 1, "type": "number" }, "responseType": { "description": "Response mode. \"fast\" (default): returns up to 300 results directly (use limit param to reduce). \"paging\": async paginated results (100/page), poll via checkOperationStatus. \"csv\": async single CSV download, poll for S3 link.", "enum": [ "fast", "paging", "csv" ], "type": "string" }, "startDate": { "type": "string" }, "tableName": { "description": "Cached table name from previous pagination request. Required when fetching pageNumber \u003e 1. Returned in first page response.", "type": "string" }, "userPrompt": { "description": "CRITICAL FOR ACCURACY: Include the complete user question to enable query optimization and context-aware filtering.", "type": "string" } }, "required": [ "hashtags" ], "type": "object" }, "annotations": { "destructiveHint": false, "idempotentHint": false, "openWorldHint": true, "readOnlyHint": true, "title": "Tiktok: Get Posts by Hashtags" } }, { "name": "searchTiktokSounds", "description": "Search Tiktok sounds/music by keyword. Use to discover sound/music objects (by title, artist, or album), then pass the returned id to getTiktokPostsBySound to find posts using that sound. Optional fields parameter (default: [\"id\", \"title\", \"author\", \"userCount\"]). Returns: array of sounds (up to 300) with id, title, author, userCount. This is a safe, read-only tool for analyzing searchable information. ", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "_isTrial": { "type": "boolean" }, "_requestId": { "type": "string" }, "_trialToken": { "type": "string" }, "feedback": { "description": "Optional. Any free-form feedback you want to share — about this tool, other tools, the platform overall, or anything else. Feedback does NOT have to be about the current tool: you can use this field to comment on a different tool you used earlier, flag missing functionality, request a new tool, or share general impressions. Examples: \"wish getTwitterPostsByKeywords supported language filtering\", \"auth flow was confusing\", \"would be useful to have a tool that lists the members of a Twitter list\", \"loved how fast this was\". Captured for product feedback; does not affect tool behavior.", "type": "string" }, "fields": { "description": "PERFORMANCE OPTIMIZATION: Specify fields you need. DEFAULT (if omitted): [\"id\", \"title\", \"author\", \"userCount\"]. AVAILABLE FIELDS: id, title, author, album, duration (seconds), userCount (number of posts using the sound), isOriginal, isCommerceMusic, isOriginalSound.", "items": { "type": "string" }, "type": "array" }, "keyword": { "description": "Search query for Tiktok sounds/music. Matches sound title, artist, or album name.", "minLength": 1, "type": "string" }, "limit": { "description": "Maximum number of sounds to return. Default: 300, Max: 300.", "maximum": 300, "minimum": 1, "type": "number" }, "userPrompt": { "description": "CRITICAL FOR ACCURACY: Include the complete user question to enable query optimization and context-aware filtering.", "type": "string" } }, "required": [ "keyword" ], "type": "object" }, "annotations": { "destructiveHint": false, "idempotentHint": false, "openWorldHint": true, "readOnlyHint": true, "title": "Tiktok: Search Sounds" } }, { "name": "getTiktokPostsBySound", "description": "Get Tiktok posts that use a specific sound/music with three response modes. Required: soundId (numeric ID from searchTiktokSounds). FAST (default, omit responseType or responseType=\"fast\"): Returns up to 300 results directly (use limit param to reduce, e.g. limit=5). PAGING (responseType=\"paging\"): Async paginated results (100/page), returns operationId for polling via checkOperationStatus. Supports pageNumber/tableName for subsequent pages. CSV (responseType=\"csv\"): Async single CSV download, returns operationId, poll for S3 link. Returns by default: id, description, username, createdAtDate. NOT for keyword/phrase search - use getTiktokPostsByKeywords. NOT for hashtags - use getTiktokPostsByHashtags. Date filters: OMIT startDate/endDate by default. ONLY pass if user explicitly requests a date range (YYYY-MM-DD). \n IMPORTANT!!!!!: THE CURRENT YEAR IS 2026.\n When user requests relative dates (last week, last month), verify the current date from your \n system context and double-check the calculated dates - models often get the year wrong, searching one year earlier than intended. \nFIELDS parameter (optional): Core (id, description, userId, username, nickname, createdAtDate), Engagement (likeCount, commentCount, playCount, forwardCount, collectCount, downloadCount), Media (videoThumbnail, videoUrl, duration, postType), Content (hashtags, transcriptsJson). This is a safe, read-only tool for analyzing searchable information. ", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "_isTrial": { "type": "boolean" }, "_requestId": { "type": "string" }, "_trialToken": { "type": "string" }, "endDate": { "type": "string" }, "feedback": { "description": "Optional. Any free-form feedback you want to share — about this tool, other tools, the platform overall, or anything else. Feedback does NOT have to be about the current tool: you can use this field to comment on a different tool you used earlier, flag missing functionality, request a new tool, or share general impressions. Examples: \"wish getTwitterPostsByKeywords supported language filtering\", \"auth flow was confusing\", \"would be useful to have a tool that lists the members of a Twitter list\", \"loved how fast this was\". Captured for product feedback; does not affect tool behavior.", "type": "string" }, "fields": { "description": "PERFORMANCE OPTIMIZATION: Specify fields you need. DEFAULT (if omitted): [\"id\", \"description\", \"username\", \"createdAtDate\"]. AVAILABLE FIELDS: Core: id, postType, isPrivate, userId, username, nickname, description, descriptionLanguage, createdAt, createdAtTimestamp, createdAtDate. Engagement: collectCount, commentCount, likeCount, downloadCount, forwardCount, playCount. Media: videoThumbnail, videoUrl (array of video URLs), duration (video length in seconds). Content: hashtags (array of hashtag strings). EXAMPLES: [\"id\", \"description\"] for minimal, [\"id\", \"description\", \"username\", \"createdAtDate\", \"likeCount\", \"playCount\"] for basic analysis, [\"id\", \"description\", \"hashtags\", \"duration\", \"videoUrl\"] for video content analysis.", "items": { "type": "string" }, "type": "array" }, "forceLatest": { "description": "USE SPARINGLY: Force fetching the latest data from the API, bypassing cache checks. Only use when explicitly required (e.g., \"get the latest\", \"most recent\", \"real-time\"). WARNING: Increases latency and API costs. Default: false (uses intelligent caching).", "type": "boolean" }, "limit": { "description": "Max results to return. Fast mode: capped at 300 (default: 300). Paging/CSV modes: caps total exported rows (default: all, max 500K).", "maximum": 500000, "minimum": 1, "type": "number" }, "pageNumber": { "description": "Page number to fetch (1-indexed). Must be provided with tableName to fetch subsequent pages. Omit for first page.", "minimum": 1, "type": "number" }, "pageNumberEnd": { "description": "Optional ending page number for fetching multiple consecutive pages at once. Must be \u003e= pageNumber. Requires tableName.", "minimum": 1, "type": "number" }, "responseType": { "description": "Response mode. \"fast\" (default): returns up to 300 results directly (use limit param to reduce). \"paging\": async paginated results (100/page), poll via checkOperationStatus. \"csv\": async single CSV download, poll for S3 link.", "enum": [ "fast", "paging", "csv" ], "type": "string" }, "soundId": { "description": "Tiktok sound/music ID (numeric string). Get IDs from searchTiktokSounds. Example: \"7016547803243907841\".", "pattern": "^\\d{1,50}$", "type": "string" }, "startDate": { "type": "string" }, "tableName": { "description": "Cached table name from previous pagination request. Required when fetching pageNumber \u003e 1. Returned in first page response.", "type": "string" }, "userPrompt": { "description": "CRITICAL FOR ACCURACY: Include the complete user question to enable query optimization and context-aware filtering.", "type": "string" } }, "required": [ "soundId" ], "type": "object" }, "annotations": { "destructiveHint": false, "idempotentHint": false, "openWorldHint": true, "readOnlyHint": true, "title": "Tiktok: Get Posts by Sound" } }, { "name": "getTiktokCommentsByPostId", "description": "Get COMMENT CONTENT (text, likes) for a Tiktok post. Returns the actual comment objects with text and metadata. RETURNS COMMENT DATA: id, text, username, createdAtDate, likeCount. Use for reading what people said. FAST (default, omit responseType or responseType=\"fast\"): Returns up to 300 results directly (use limit param to reduce, e.g. limit=5). Auto API fallback for fresh data. PAGING (responseType=\"paging\"): Async paginated results (100/page), returns operationId for polling via checkOperationStatus. Supports pageNumber/tableName for subsequent pages. CSV (responseType=\"csv\"): Async single CSV download, returns operationId, poll for S3 link. CODE EXECUTION: For csv mode, download CSV and use code execution to analyze full dataset. Ideal for: sentiment analysis, reading discussions, analyzing comment content, engagement patterns. Date filters: OMIT startDate/endDate by default. ONLY pass if user explicitly requests date range. \n IMPORTANT!!!!!: THE CURRENT YEAR IS 2026.\n When user requests relative dates (last week, last month), verify the current date from your \n system context and double-check the calculated dates - models often get the year wrong, searching one year earlier than intended. \nOptional fields: [\"id\", \"text\", \"username\", \"createdAtDate\", \"likeCount\"]. This is a safe, read-only tool for analyzing searchable information. ", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "_isTrial": { "type": "boolean" }, "_requestId": { "type": "string" }, "_trialToken": { "type": "string" }, "endDate": { "type": "string" }, "feedback": { "description": "Optional. Any free-form feedback you want to share — about this tool, other tools, the platform overall, or anything else. Feedback does NOT have to be about the current tool: you can use this field to comment on a different tool you used earlier, flag missing functionality, request a new tool, or share general impressions. Examples: \"wish getTwitterPostsByKeywords supported language filtering\", \"auth flow was confusing\", \"would be useful to have a tool that lists the members of a Twitter list\", \"loved how fast this was\". Captured for product feedback; does not affect tool behavior.", "type": "string" }, "fields": { "description": "PERFORMANCE OPTIMIZATION: Specify fields you need. DEFAULT (if omitted): [\"id\", \"text\", \"username\", \"createdAtDate\"]. AVAILABLE FIELDS: Core: id, text, postId, userId, username, createdAt, createdAtTimestamp, createdAtDate. Engagement: likeCount. EXAMPLES: [\"id\", \"text\"] for minimal, [\"id\", \"text\", \"username\", \"createdAtDate\", \"likeCount\"] for basic analysis.", "items": { "type": "string" }, "type": "array" }, "forceLatest": { "description": "USE SPARINGLY: Force fetching the latest data from the API, bypassing cache checks. Only use when explicitly required (e.g., \"get the latest\", \"most recent\", \"real-time\"). WARNING: Increases latency and API costs. Default: false (uses intelligent caching).", "type": "boolean" }, "limit": { "description": "Max results to return. Fast mode: capped at 300 (default: 300). Paging/CSV modes: caps total exported rows (default: all, max 500K).", "maximum": 500000, "minimum": 1, "type": "number" }, "pageNumber": { "description": "Page number to fetch (1-indexed). Must be provided with tableName to fetch subsequent pages. Omit for first page.", "minimum": 1, "type": "number" }, "pageNumberEnd": { "description": "Optional ending page number for fetching multiple consecutive pages at once. Must be \u003e= pageNumber. Requires tableName.", "minimum": 1, "type": "number" }, "postId": { "description": "Tiktok post ID to fetch comments for.", "minLength": 1, "type": "string" }, "responseType": { "description": "Response mode. \"fast\" (default): returns up to 300 results directly (use limit param to reduce). \"paging\": async paginated results (100/page), poll via checkOperationStatus. \"csv\": async single CSV download, poll for S3 link.", "enum": [ "fast", "paging", "csv" ], "type": "string" }, "startDate": { "type": "string" }, "tableName": { "description": "Cached table name from previous pagination request. Required when fetching pageNumber \u003e 1. Returned in first page response.", "type": "string" }, "userPrompt": { "description": "CRITICAL FOR ACCURACY: Include the complete user question to enable query optimization and context-aware filtering.", "type": "string" } }, "required": [ "postId" ], "type": "object" }, "annotations": { "destructiveHint": false, "idempotentHint": false, "openWorldHint": true, "readOnlyHint": true, "title": "Tiktok: Get Post Comments" } }, { "name": "getUserAccessKey", "description": "Retrieve authenticated user access key. Required: authentication, confirmation. Returns: access key, metadata.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "_requestId": { "type": "string" }, "confirmRetrieval": { "description": "Must be true to retrieve key. Security confirmation required.", "type": "boolean" }, "feedback": { "description": "Optional. Any free-form feedback you want to share — about this tool, other tools, the platform overall, or anything else. Feedback does NOT have to be about the current tool: you can use this field to comment on a different tool you used earlier, flag missing functionality, request a new tool, or share general impressions. Examples: \"wish getTwitterPostsByKeywords supported language filtering\", \"auth flow was confusing\", \"would be useful to have a tool that lists the members of a Twitter list\", \"loved how fast this was\". Captured for product feedback; does not affect tool behavior.", "type": "string" } }, "required": [ "confirmRetrieval" ], "type": "object" }, "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true, "title": "Auth: Get User Access Key" } }, { "name": "checkAccessKeyStatus", "description": "Check access key status without revealing key. Required: authentication. Returns: status, metadata.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "_requestId": { "type": "string" }, "feedback": { "description": "Optional. Any free-form feedback you want to share — about this tool, other tools, the platform overall, or anything else. Feedback does NOT have to be about the current tool: you can use this field to comment on a different tool you used earlier, flag missing functionality, request a new tool, or share general impressions. Examples: \"wish getTwitterPostsByKeywords supported language filtering\", \"auth flow was confusing\", \"would be useful to have a tool that lists the members of a Twitter list\", \"loved how fast this was\". Captured for product feedback; does not affect tool behavior.", "type": "string" } }, "type": "object" }, "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true, "title": "Auth: Check Access Key Status" } }, { "name": "getTrackedItems", "description": "Get tracked keywords and users. Returns: phrase, type (keyword/user/subreddit/hashtag), platform (twitter/instagram/reddit/tiktok). Subreddit is Reddit-only, hashtag is TikTok-only.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "_isTrial": { "type": "boolean" }, "_requestId": { "type": "string" }, "_trialToken": { "type": "string" }, "feedback": { "description": "Optional. Any free-form feedback you want to share — about this tool, other tools, the platform overall, or anything else. Feedback does NOT have to be about the current tool: you can use this field to comment on a different tool you used earlier, flag missing functionality, request a new tool, or share general impressions. Examples: \"wish getTwitterPostsByKeywords supported language filtering\", \"auth flow was confusing\", \"would be useful to have a tool that lists the members of a Twitter list\", \"loved how fast this was\". Captured for product feedback; does not affect tool behavior.", "type": "string" } }, "type": "object" }, "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true, "title": "Tracking: Get Tracked Items" } }, { "name": "addTrackedItems", "description": "Add keywords/users to track. Accepts array of items with phrase, type (keyword/user/subreddit/hashtag), platform (twitter/instagram/reddit/tiktok). Subreddit is Reddit-only, hashtag is TikTok-only. Returns error if plan limit exceeded.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "_isTrial": { "type": "boolean" }, "_requestId": { "type": "string" }, "_trialToken": { "type": "string" }, "feedback": { "description": "Optional. Any free-form feedback you want to share — about this tool, other tools, the platform overall, or anything else. Feedback does NOT have to be about the current tool: you can use this field to comment on a different tool you used earlier, flag missing functionality, request a new tool, or share general impressions. Examples: \"wish getTwitterPostsByKeywords supported language filtering\", \"auth flow was confusing\", \"would be useful to have a tool that lists the members of a Twitter list\", \"loved how fast this was\". Captured for product feedback; does not affect tool behavior.", "type": "string" }, "items": { "description": "Array of items to track. Each item has phrase, type, and platform.", "items": { "additionalProperties": false, "properties": { "phrase": { "description": "The keyword, username, subreddit name, or hashtag.", "minLength": 1, "type": "string" }, "platform": { "description": "Platform: \"twitter\", \"instagram\", \"reddit\", or \"tiktok\".", "enum": [ "twitter", "instagram", "reddit", "tiktok" ], "type": "string" }, "type": { "description": "Type of tracked item: \"keyword\", \"user\", \"subreddit\" (Reddit only), or \"hashtag\" (TikTok only).", "enum": [ "keyword", "user", "subreddit", "hashtag" ], "type": "string" } }, "required": [ "phrase", "type", "platform" ], "type": "object" }, "minItems": 1, "type": "array" } }, "required": [ "items" ], "type": "object" }, "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": false, "title": "Tracking: Add Tracked Items" } }, { "name": "removeTrackedItems", "description": "Remove tracked keywords/users. Accepts array of items with phrase, type (keyword/user/subreddit/hashtag), platform (twitter/instagram/reddit/tiktok). Subreddit is Reddit-only, hashtag is TikTok-only. Use getTrackedItems first to see current items.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "_isTrial": { "type": "boolean" }, "_requestId": { "type": "string" }, "_trialToken": { "type": "string" }, "feedback": { "description": "Optional. Any free-form feedback you want to share — about this tool, other tools, the platform overall, or anything else. Feedback does NOT have to be about the current tool: you can use this field to comment on a different tool you used earlier, flag missing functionality, request a new tool, or share general impressions. Examples: \"wish getTwitterPostsByKeywords supported language filtering\", \"auth flow was confusing\", \"would be useful to have a tool that lists the members of a Twitter list\", \"loved how fast this was\". Captured for product feedback; does not affect tool behavior.", "type": "string" }, "items": { "description": "Array of tracked items to remove. Use getTrackedItems to see current items.", "items": { "additionalProperties": false, "properties": { "phrase": { "description": "The keyword, username, subreddit name, or hashtag.", "minLength": 1, "type": "string" }, "platform": { "description": "Platform: \"twitter\", \"instagram\", \"reddit\", or \"tiktok\".", "enum": [ "twitter", "instagram", "reddit", "tiktok" ], "type": "string" }, "type": { "description": "Type of tracked item: \"keyword\", \"user\", \"subreddit\" (Reddit only), or \"hashtag\" (TikTok only).", "enum": [ "keyword", "user", "subreddit", "hashtag" ], "type": "string" } }, "required": [ "phrase", "type", "platform" ], "type": "object" }, "minItems": 1, "type": "array" } }, "required": [ "items" ], "type": "object" }, "annotations": { "destructiveHint": true, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": false, "title": "Tracking: Remove Tracked Items" } }, { "name": "getAccountDetails", "description": "Get authenticated user's account details: plan (name, features), billing (period, next renewal date; null for Free plan), and usage (subscription credits remaining, extra credits remaining, extra tracked items). Required: authentication. Returns: nested plan/billing/usage object.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "_requestId": { "type": "string" }, "feedback": { "description": "Optional. Any free-form feedback you want to share — about this tool, other tools, the platform overall, or anything else. Feedback does NOT have to be about the current tool: you can use this field to comment on a different tool you used earlier, flag missing functionality, request a new tool, or share general impressions. Examples: \"wish getTwitterPostsByKeywords supported language filtering\", \"auth flow was confusing\", \"would be useful to have a tool that lists the members of a Twitter list\", \"loved how fast this was\". Captured for product feedback; does not affect tool behavior.", "type": "string" } }, "type": "object" }, "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true, "title": "Account: Get Account Details" } }, { "name": "getCreditsUsageHistory", "description": "Get authenticated user's credits and export-rows usage over time, for analyzing usage patterns. Params: range (\"today\" | \"7d\" | \"current_month\" | \"lifetime\", default current_month), granularity (\"hour\" | \"day\", default day). Returns time-series buckets for both credits and exportRows, each with subscriptionUsed, extraUsed, totalUsed, extraPurchased. Use for trend analysis and spotting usage spikes. For current remaining balances, use getAccountDetails instead. Required: authentication.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "_requestId": { "type": "string" }, "feedback": { "description": "Optional. Any free-form feedback you want to share — about this tool, other tools, the platform overall, or anything else. Feedback does NOT have to be about the current tool: you can use this field to comment on a different tool you used earlier, flag missing functionality, request a new tool, or share general impressions. Examples: \"wish getTwitterPostsByKeywords supported language filtering\", \"auth flow was confusing\", \"would be useful to have a tool that lists the members of a Twitter list\", \"loved how fast this was\". Captured for product feedback; does not affect tool behavior.", "type": "string" }, "granularity": { "default": "day", "description": "Bucket size for the time series. \"hour\" = hourly buckets (best with range=today or 7d), \"day\" = daily buckets. Default: day.", "enum": [ "hour", "day" ], "type": "string" }, "range": { "default": "current_month", "description": "Time window to analyze. \"today\" = current day, \"7d\" = last 7 days, \"current_month\" = current calendar month, \"lifetime\" = all time. Default: current_month.", "enum": [ "today", "7d", "current_month", "lifetime" ], "type": "string" } }, "type": "object" }, "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true, "title": "Account: Get Credits Usage History" } } ], "schemaTokens": 58290, "changedAt": "2026-11-08T02:03:10.124135678Z", "check": { "checker": "anchor-check/1.0", "totalTokens": 58290, "counts": { "error": 0, "note": 2, "warn": 80 }, "findings": [ { "rule": "TC07", "severity": "warn", "tool": "getInstagramPostsByKeywords", "message": "the description is about 567 tokens", "fix": "Keep the description to what a model needs to choose and call the tool; move the manual to a resource or the docs." }, { "rule": "TC07", "severity": "warn", "tool": "getInstagramUsersByKeywords", "message": "the description is about 664 tokens", "fix": "Keep the description to what a model needs to choose and call the tool; move the manual to a resource or the docs." }, { "rule": "TC07", "severity": "warn", "tool": "getRedditPostsByKeywords", "message": "the description is about 581 tokens", "fix": "Keep the description to what a model needs to choose and call the tool; move the manual to a resource or the docs." }, { "rule": "TC07", "severity": "warn", "tool": "getRedditUsersByKeywords", "message": "the description is about 617 tokens", "fix": "Keep the description to what a model needs to choose and call the tool; move the manual to a resource or the docs." }, { "rule": "TC07", "severity": "warn", "tool": "getTiktokPostsByKeywords", "message": "the description is about 525 tokens", "fix": "Keep the description to what a model needs to choose and call the tool; move the manual to a resource or the docs." }, { "rule": "TC07", "severity": "warn", "tool": "getTiktokUsersByKeywords", "message": "the description is about 524 tokens", "fix": "Keep the description to what a model needs to choose and call the tool; move the manual to a resource or the docs." }, { "rule": "TC07", "severity": "warn", "tool": "getTwitterPostInteractingUsers", "message": "the description is about 512 tokens", "fix": "Keep the description to what a model needs to choose and call the tool; move the manual to a resource or the docs." }, { "rule": "TC07", "severity": "warn", "tool": "getTwitterPostsByKeywords", "message": "the description is about 660 tokens", "fix": "Keep the description to what a model needs to choose and call the tool; move the manual to a resource or the docs." }, { "rule": "TC07", "severity": "warn", "tool": "getTwitterUsersByKeywords", "message": "the description is about 678 tokens", "fix": "Keep the description to what a model needs to choose and call the tool; move the manual to a resource or the docs." }, { "rule": "TC11", "severity": "warn", "tool": "addTrackedItems", "message": "3 parameters without a description: _isTrial, _requestId, _trialToken", "fix": "Describe each one: format, units, an example, and what happens when it's left out." }, { "rule": "TC11", "severity": "warn", "tool": "cancelOperation", "message": "1 parameter without a description: _requestId", "fix": "Describe each one: format, units, an example, and what happens when it's left out." }, { "rule": "TC11", "severity": "warn", "tool": "checkAccessKeyStatus", "message": "1 parameter without a description: _requestId", "fix": "Describe each one: format, units, an example, and what happens when it's left out." }, { "rule": "TC11", "severity": "warn", "tool": "checkOperationStatus", "message": "1 parameter without a description: _requestId", "fix": "Describe each one: format, units, an example, and what happens when it's left out." }, { "rule": "TC11", "severity": "warn", "tool": "countTweets", "message": "3 parameters without a description: _isTrial, _requestId, _trialToken", "fix": "Describe each one: format, units, an example, and what happens when it's left out." }, { "rule": "TC11", "severity": "warn", "tool": "getAccountDetails", "message": "1 parameter without a description: _requestId", "fix": "Describe each one: format, units, an example, and what happens when it's left out." }, { "rule": "TC11", "severity": "warn", "tool": "getCreditsUsageHistory", "message": "1 parameter without a description: _requestId", "fix": "Describe each one: format, units, an example, and what happens when it's left out." }, { "rule": "TC11", "severity": "warn", "tool": "getInstagramCommentsByPostId", "message": "5 parameters without a description: _isTrial, _requestId, _trialToken, endDate, startDate", "fix": "Describe each one: format, units, an example, and what happens when it's left out." }, { "rule": "TC11", "severity": "warn", "tool": "getInstagramPostInteractingUsers", "message": "3 parameters without a description: _isTrial, _requestId, _trialToken", "fix": "Describe each one: format, units, an example, and what happens when it's left out." }, { "rule": "TC11", "severity": "warn", "tool": "getInstagramPostsByIds", "message": "3 parameters without a description: _isTrial, _requestId, _trialToken", "fix": "Describe each one: format, units, an example, and what happens when it's left out." }, { "rule": "TC11", "severity": "warn", "tool": "getInstagramPostsByKeywords", "message": "5 parameters without a description: _isTrial, _requestId, _trialToken, endDate, startDate", "fix": "Describe each one: format, units, an example, and what happens when it's left out." }, { "rule": "TC11", "severity": "warn", "tool": "getInstagramPostsByUser", "message": "5 parameters without a description: _isTrial, _requestId, _trialToken, endDate, startDate", "fix": "Describe each one: format, units, an example, and what happens when it's left out." }, { "rule": "TC11", "severity": "warn", "tool": "getInstagramUser", "message": "3 parameters without a description: _isTrial, _requestId, _trialToken", "fix": "Describe each one: format, units, an example, and what happens when it's left out." }, { "rule": "TC11", "severity": "warn", "tool": "getInstagramUserConnections", "message": "3 parameters without a description: _isTrial, _requestId, _trialToken", "fix": "Describe each one: format, units, an example, and what happens when it's left out." }, { "rule": "TC11", "severity": "warn", "tool": "getInstagramUsersByKeywords", "message": "5 parameters without a description: _isTrial, _requestId, _trialToken, endDate, startDate", "fix": "Describe each one: format, units, an example, and what happens when it's left out." }, { "rule": "TC11", "severity": "warn", "tool": "getRedditCommentById", "message": "3 parameters without a description: _isTrial, _requestId, _trialToken", "fix": "Describe each one: format, units, an example, and what happens when it's left out." }, { "rule": "TC11", "severity": "warn", "tool": "getRedditCommentsByKeywords", "message": "5 parameters without a description: _isTrial, _requestId, _trialToken, endDate, startDate", "fix": "Describe each one: format, units, an example, and what happens when it's left out." }, { "rule": "TC11", "severity": "warn", "tool": "getRedditPostWithCommentsById", "message": "3 parameters without a description: _isTrial, _requestId, _trialToken", "fix": "Describe each one: format, units, an example, and what happens when it's left out." }, { "rule": "TC11", "severity": "warn", "tool": "getRedditPostsByKeywords", "message": "5 parameters without a description: _isTrial, _requestId, _trialToken, endDate, startDate", "fix": "Describe each one: format, units, an example, and what happens when it's left out." }, { "rule": "TC11", "severity": "warn", "tool": "getRedditSubredditWithPostsByName", "message": "3 parameters without a description: _isTrial, _requestId, _trialToken", "fix": "Describe each one: format, units, an example, and what happens when it's left out." }, { "rule": "TC11", "severity": "warn", "tool": "getRedditSubredditsByKeywords", "message": "3 parameters without a description: _isTrial, _requestId, _trialToken", "fix": "Describe each one: format, units, an example, and what happens when it's left out." }, { "rule": "TC11", "severity": "warn", "tool": "getRedditUser", "message": "3 parameters without a description: _isTrial, _requestId, _trialToken", "fix": "Describe each one: format, units, an example, and what happens when it's left out." }, { "rule": "TC11", "severity": "warn", "tool": "getRedditUsersByKeywords", "message": "3 parameters without a description: _isTrial, _requestId, _trialToken", "fix": "Describe each one: format, units, an example, and what happens when it's left out." }, { "rule": "TC11", "severity": "warn", "tool": "getTiktokCommentsByPostId", "message": "5 parameters without a description: _isTrial, _requestId, _trialToken, endDate, startDate", "fix": "Describe each one: format, units, an example, and what happens when it's left out." }, { "rule": "TC11", "severity": "warn", "tool": "getTiktokPostsByHashtags", "message": "5 parameters without a description: _isTrial, _requestId, _trialToken, endDate, startDate", "fix": "Describe each one: format, units, an example, and what happens when it's left out." }, { "rule": "TC11", "severity": "warn", "tool": "getTiktokPostsByIds", "message": "3 parameters without a description: _isTrial, _requestId, _trialToken", "fix": "Describe each one: format, units, an example, and what happens when it's left out." }, { "rule": "TC11", "severity": "warn", "tool": "getTiktokPostsByKeywords", "message": "5 parameters without a description: _isTrial, _requestId, _trialToken, endDate, startDate", "fix": "Describe each one: format, units, an example, and what happens when it's left out." }, { "rule": "TC11", "severity": "warn", "tool": "getTiktokPostsBySound", "message": "5 parameters without a description: _isTrial, _requestId, _trialToken, endDate, startDate", "fix": "Describe each one: format, units, an example, and what happens when it's left out." }, { "rule": "TC11", "severity": "warn", "tool": "getTiktokPostsByUser", "message": "5 parameters without a description: _isTrial, _requestId, _trialToken, endDate, startDate", "fix": "Describe each one: format, units, an example, and what happens when it's left out." }, { "rule": "TC11", "severity": "warn", "tool": "getTiktokUser", "message": "3 parameters without a description: _isTrial, _requestId, _trialToken", "fix": "Describe each one: format, units, an example, and what happens when it's left out." }, { "rule": "TC11", "severity": "warn", "tool": "getTiktokUsersByHashtags", "message": "5 parameters without a description: _isTrial, _requestId, _trialToken, endDate, startDate", "fix": "Describe each one: format, units, an example, and what happens when it's left out." }, { "rule": "TC11", "severity": "warn", "tool": "getTiktokUsersByKeywords", "message": "5 parameters without a description: _isTrial, _requestId, _trialToken, endDate, startDate", "fix": "Describe each one: format, units, an example, and what happens when it's left out." }, { "rule": "TC11", "severity": "warn", "tool": "getTrackedItems", "message": "3 parameters without a description: _isTrial, _requestId, _trialToken", "fix": "Describe each one: format, units, an example, and what happens when it's left out." }, { "rule": "TC11", "severity": "warn", "tool": "getTwitterPostComments", "message": "4 parameters without a description: _isTrial, _requestId, _trialToken, startDate", "fix": "Describe each one: format, units, an example, and what happens when it's left out." }, { "rule": "TC11", "severity": "warn", "tool": "getTwitterPostInteractingUsers", "message": "5 parameters without a description: _isTrial, _requestId, _trialToken, endDate, startDate", "fix": "Describe each one: format, units, an example, and what happens when it's left out." }, { "rule": "TC11", "severity": "warn", "tool": "getTwitterPostQuotes", "message": "4 parameters without a description: _isTrial, _requestId, _trialToken, startDate", "fix": "Describe each one: format, units, an example, and what happens when it's left out." }, { "rule": "TC11", "severity": "warn", "tool": "getTwitterPostRetweets", "message": "5 parameters without a description: _isTrial, _requestId, _trialToken, endDate, startDate", "fix": "Describe each one: format, units, an example, and what happens when it's left out." }, { "rule": "TC11", "severity": "warn", "tool": "getTwitterPostsByAuthor", "message": "5 parameters without a description: _isTrial, _requestId, _trialToken, endDate, startDate", "fix": "Describe each one: format, units, an example, and what happens when it's left out." }, { "rule": "TC11", "severity": "warn", "tool": "getTwitterPostsByIds", "message": "3 parameters without a description: _isTrial, _requestId, _trialToken", "fix": "Describe each one: format, units, an example, and what happens when it's left out." }, { "rule": "TC11", "severity": "warn", "tool": "getTwitterPostsByKeywords", "message": "6 parameters without a description: _isTrial, _requestId, _trialToken, endDate, language, startDate", "fix": "Describe each one: format, units, an example, and what happens when it's left out." }, { "rule": "TC11", "severity": "warn", "tool": "getTwitterUser", "message": "3 parameters without a description: _isTrial, _requestId, _trialToken", "fix": "Describe each one: format, units, an example, and what happens when it's left out." }, { "rule": "TC11", "severity": "warn", "tool": "getTwitterUserConnections", "message": "3 parameters without a description: _isTrial, _requestId, _trialToken", "fix": "Describe each one: format, units, an example, and what happens when it's left out." }, { "rule": "TC11", "severity": "warn", "tool": "getTwitterUsers", "message": "3 parameters without a description: _isTrial, _requestId, _trialToken", "fix": "Describe each one: format, units, an example, and what happens when it's left out." }, { "rule": "TC11", "severity": "warn", "tool": "getTwitterUsersByKeywords", "message": "5 parameters without a description: _isTrial, _requestId, _trialToken, endDate, startDate", "fix": "Describe each one: format, units, an example, and what happens when it's left out." }, { "rule": "TC11", "severity": "warn", "tool": "getUserAccessKey", "message": "1 parameter without a description: _requestId", "fix": "Describe each one: format, units, an example, and what happens when it's left out." }, { "rule": "TC11", "severity": "warn", "tool": "removeTrackedItems", "message": "3 parameters without a description: _isTrial, _requestId, _trialToken", "fix": "Describe each one: format, units, an example, and what happens when it's left out." }, { "rule": "TC11", "severity": "warn", "tool": "searchInstagramUsers", "message": "3 parameters without a description: _isTrial, _requestId, _trialToken", "fix": "Describe each one: format, units, an example, and what happens when it's left out." }, { "rule": "TC11", "severity": "warn", "tool": "searchRedditSubreddits", "message": "3 parameters without a description: _isTrial, _requestId, _trialToken", "fix": "Describe each one: format, units, an example, and what happens when it's left out." }, { "rule": "TC11", "severity": "warn", "tool": "searchRedditUsers", "message": "3 parameters without a description: _isTrial, _requestId, _trialToken", "fix": "Describe each one: format, units, an example, and what happens when it's left out." }, { "rule": "TC11", "severity": "warn", "tool": "searchTiktokSounds", "message": "3 parameters without a description: _isTrial, _requestId, _trialToken", "fix": "Describe each one: format, units, an example, and what happens when it's left out." }, { "rule": "TC11", "severity": "warn", "tool": "searchTiktokUsers", "message": "3 parameters without a description: _isTrial, _requestId, _trialToken", "fix": "Describe each one: format, units, an example, and what happens when it's left out." }, { "rule": "TC11", "severity": "warn", "tool": "searchTwitterUsers", "message": "5 parameters without a description: _isTrial, _requestId, _trialToken, limit, name", "fix": "Describe each one: format, units, an example, and what happens when it's left out." }, { "rule": "TC18", "severity": "warn", "tool": "cancelOperation", "message": "destructiveHint is false but the name says \"cancel\"", "fix": "If it deletes, overwrites or moves money, destructiveHint should be true." }, { "rule": "TC21", "severity": "warn", "tool": "getInstagramUsersByKeywords", "message": "described almost the same as getRedditUsersByKeywords (86% of the same words)", "fix": "Say in each description when to use it instead of the other." }, { "rule": "TC21", "severity": "warn", "tool": "getInstagramUsersByKeywords", "message": "described almost the same as getTiktokUsersByKeywords (82% of the same words)", "fix": "Say in each description when to use it instead of the other." }, { "rule": "TC21", "severity": "warn", "tool": "getRedditUsersByKeywords", "message": "described almost the same as getTiktokUsersByKeywords (82% of the same words)", "fix": "Say in each description when to use it instead of the other." }, { "rule": "TC21", "severity": "warn", "tool": "getTwitterPostQuotes", "message": "described almost the same as getTwitterPostComments (85% of the same words)", "fix": "Say in each description when to use it instead of the other." }, { "rule": "TC21", "severity": "warn", "tool": "getTwitterUsersByKeywords", "message": "described almost the same as getInstagramUsersByKeywords (82% of the same words)", "fix": "Say in each description when to use it instead of the other." }, { "rule": "TC21", "severity": "warn", "tool": "getTwitterUsersByKeywords", "message": "described almost the same as getRedditUsersByKeywords (81% of the same words)", "fix": "Say in each description when to use it instead of the other." }, { "rule": "TC22", "severity": "warn", "tool": "getInstagramPostsByKeywords", "message": "the definition is about 1,570 tokens", "fix": "Trim the description and parameter docs, or split the tool." }, { "rule": "TC22", "severity": "warn", "tool": "getInstagramUsersByKeywords", "message": "the definition is about 1,902 tokens", "fix": "Trim the description and parameter docs, or split the tool." }, { "rule": "TC22", "severity": "warn", "tool": "getRedditCommentsByKeywords", "message": "the definition is about 1,511 tokens", "fix": "Trim the description and parameter docs, or split the tool." }, { "rule": "TC22", "severity": "warn", "tool": "getRedditPostsByKeywords", "message": "the definition is about 1,888 tokens", "fix": "Trim the description and parameter docs, or split the tool." }, { "rule": "TC22", "severity": "warn", "tool": "getRedditSubredditsByKeywords", "message": "the definition is about 1,718 tokens", "fix": "Trim the description and parameter docs, or split the tool." }, { "rule": "TC22", "severity": "warn", "tool": "getRedditUsersByKeywords", "message": "the definition is about 1,920 tokens", "fix": "Trim the description and parameter docs, or split the tool." }, { "rule": "TC22", "severity": "warn", "tool": "getTiktokUsersByKeywords", "message": "the definition is about 1,609 tokens", "fix": "Trim the description and parameter docs, or split the tool." }, { "rule": "TC22", "severity": "warn", "tool": "getTwitterPostInteractingUsers", "message": "the definition is about 1,604 tokens", "fix": "Trim the description and parameter docs, or split the tool." }, { "rule": "TC22", "severity": "warn", "tool": "getTwitterPostsByAuthor", "message": "the definition is about 1,539 tokens", "fix": "Trim the description and parameter docs, or split the tool." }, { "rule": "TC22", "severity": "warn", "tool": "getTwitterPostsByKeywords", "message": "the definition is about 2,310 tokens", "fix": "Trim the description and parameter docs, or split the tool." }, { "rule": "TC22", "severity": "warn", "tool": "getTwitterUsersByKeywords", "message": "the definition is about 1,990 tokens", "fix": "Trim the description and parameter docs, or split the tool." }, { "rule": "TC23", "severity": "warn", "message": "52 tools, about 58,385 tokens of definitions", "fix": "Split the server by job, or offer a smaller default toolset (a read-only set, or a search-then-call pattern)." }, { "rule": "TC11", "severity": "note", "tool": "getTwitterUsersByKeywords", "message": "a parameter is documented in the description but not in the schema: language", "fix": "Put each one in its property's description (in Python: Annotated[str, Field(description=...)])." }, { "rule": "TC24", "severity": "note", "message": "52 of 52 tools have no outputSchema", "fix": "Declare outputSchema for tools that return structured data, and return structuredContent that matches it." } ] } }, "updatedAt": "2026-11-09T01:53:34.200739267Z" }, "streak": { "days": 2, "from": "2026-11-07", "sinceWatching": true, "best": 2 } }, "edges": [ { "by": 58, "category": "maintenance", "leads": "postiz", "name": "Maintenance \u0026 community", "reasons": { "a": "v2.25.3 on 24 October 2026, and the default branch had commits on 3 November (30). v2.24.0 (22 September), v2.25.0 (2 October), v2.25.1 (9 October), v2.25.2 and v2.25.3 (24 October) in the 90 days from 6 August, each with product or security changes (20). Per the 1 October check, not re-read on 4 November, merges ran on most days and a stale workflow closes inactive issues; github.com's issue pages are unreadable to us (15). Official Node SDK (@postiz/node 1.0.8 in the repository) and CLI; npm not re-read. No official MCP registry entry (10). The build workflow builds on every push and pull request but doesn't run the repository's jest tests, the ESLint workflow has been disabled since December 2025 (its file has no .yml extension), and CodeQL runs. Dependencies were updated on 24 October. CI with no tests scores below full, as linkup's lint and build with no tests (8; 10 before). 30 + 20 + 15 + 10 + 8 = 83.", "b": "Registry entry last updated 14 July 2026 and repository commit on 9 September; the live server reports 3.0.0 (10). No dated releases in 90 days (0). Issues not read (0). Official registry entry ai.xpoz/social-insights (15). Docker packaging only (0). 10 + 0 + 0 + 15 + 0 = 25. Registry presence read from Anchor Terminal's own daily import of the official MCP registry (/api/v1/registry.json, 6 November 2026), not the registry's API." }, "scores": { "a": 83, "b": 25 } }, { "by": 53, "category": "transparency", "leads": "postiz", "name": "Transparency \u0026 trust", "reasons": { "a": "AGPL-3.0 (30). Per the 1 October check, not re-read on 4 November, the privacy policy dated 3 May 2026 keeps account data up to 90 days after closure, deletes OAuth tokens on revoke and keeps billing records about 7 years, a DPA with SCCs is signed on request, and it names Stripe, Paddle, Anthropic and OpenAI with no full list. The terms of 19 October add that personal data in user content is never used to train AI models (22). The terms promise reasonable advance notice of material changes and 30 days for price changes, and only the latest release is supported. No API deprecation policy (8). Hosted data regions given as the US, EU, UK and others per the 1 October check. In the source at v2.25.3, Sentry, Plausible, Google Tag Manager and the other analytics load only when their environment variables are set, the compose file ships Sentry commented out, and PostHog was removed on 19 October (15). 30 + 22 + 8 + 15 = 75.", "b": "Closed service; terms of use read without a legal entity (10 of 30). Data handling not read (5 of 30). No deprecation policy (0). Where the social data comes from isn't stated beyond 'no platform API keys' (0). 10 + 5 + 0 + 0 = 15." }, "scores": { "a": 82, "b": 29 } }, { "by": 24, "category": "schema", "leads": "postiz", "name": "Schema \u0026 documentation", "reasons": { "a": "OpenAPI 3.1.0 at docs.postiz.com/public-api/openapi.json with 27 paths, and zod input schemas on every MCP tool in source (25). llms.txt and Markdown versions of the docs pages (10). The MCP tool descriptions in source say when to use each tool and when not to, for example schedulePostTool says not to use it to update or delete posts (16). Enums for post type (draft, schedule, now), platform identifiers and post states, though each network's settings come from a separate integrationSchema call (12). The spec documents 400, 401, 402, 404, 406, 429 and 503, and the schedule tool returns output.errors naming what to fix (12). Tagged GitHub releases and a /public/v1 path, with no separate API changelog (13).", "b": "52 tools read from tools/list with JSON Schema inputs and 42 enums (25). No llms.txt read (0). Server instructions explain paging and field selection (16 of 20). Typed inputs with enums (15). Examples on the home page (5 of 15). Registry 1.4.1 from July, server 3.0.0; no changelog (3 of 15). 25 + 0 + 16 + 15 + 5 + 3 = 64." }, "scores": { "a": 88, "b": 64 } }, { "by": 23, "category": "reliability", "leads": "postiz", "name": "Reliability", "reasons": { "a": "Scored for Postiz Cloud, since self-hosted uptime is the operator's. Postiz's terms (last updated 19 October 2026) say users may not use the Service, which includes the site and its sub-domains, to scrape it, so on 4 November postiz.com and its sub-domains were read only for robots.txt and the terms (paused, as bundle.social). Per the 1 October check, not re-read on 4 November, status.postiz.com is Gitroom's own page and showed our reader no components, so half the line, as scrapegraphai, youtrack and getty-images-mcp (10). That check found its history empty without being able to tell a clean record from a page that didn't render, and nothing is readable today, so the window is uncredited (5, as clickup and docusign; 10 before). 90 create-post requests an hour on every Cloud plan, per the 1 October docs and the throttler default of 90 in the source at v2.25.3 (15). Per the 1 October check, the docs don't mention Retry-After, the spec documents a 429 only for clipping, and there's no idempotency key (3). No SLA found (0). The public API isn't labelled beta (10). 10 + 5 + 15 + 3 + 0 + 10 = 43.", "b": "No status page found (0). No history (5). Credit allowances, no rate limits found (5 of 15). No retry guidance (0). No SLA (0). Not labelled beta (10). 0 + 5 + 5 + 0 + 0 + 10 = 20." }, "scores": { "a": 43, "b": 20 } }, { "by": 12, "category": "security", "leads": "postiz", "name": "Security \u0026 auth", "reasons": { "a": "Per the 1 October check, not re-read on 4 November, Postiz uses one organisation API key, sent raw in the Authorization header and rotatable from settings. OAuth apps issue pos_ tokens, and the MCP does OAuth with PKCE and dynamic registration, but every grant gets both mcp:read and mcp:write. The docs also document the key in the URL path at /mcp/{key}, so less 10 (15). No read-only key or scope. Tool annotations mark schedulePostTool destructive, the new deletePostTool (14 October) carries destructiveHint in the source, and posts can go in as drafts (8). The MCP exposes no comments or inbox, so little untrusted text comes back (10). No audit log found, only notifications (2). SECURITY.md (updated 2 October 2026) routes reports through GAdvisory with 72-hour acknowledgement, 90-day critical remediation and CVE publication within 24 hours of a fix, and Postiz is a CVE Numbering Authority that published 20 advisories between March and October 2026. CI runs CodeQL. No bug bounty, certification or security.txt (14).", "b": "One API key (20 of 30). 49 of 52 tools read-only (15 of 20). Posts and profiles are third-party text; the server says all tools are 'safe and read-only' but gives no injection guidance (0). No audit log (0). No security programme found (2 of 20). 20 + 15 + 0 + 0 + 2 = 37." }, "scores": { "a": 49, "b": 37 } } ], "facts": [ { "a": "HTTP API", "b": "MCP server", "name": "Kind" }, { "a": "Postiz (Gitroom)", "b": "XPOZ", "name": "Vendor" }, { "a": "https://api.postiz.com/public/v1", "b": "https://mcp.xpoz.ai/mcp", "name": "Hosted endpoint" }, { "a": "HTTP, Streamable HTTP", "b": "Streamable HTTP", "name": "Transports" }, { "a": "OAuth or key", "b": "API key", "name": "Auth" }, { "a": "Paid", "b": "Freemium", "name": "Pricing" }, { "a": "no", "b": "no", "name": "x402" }, { "a": "AGPL-3.0", "b": "none", "name": "Licence" }, { "a": "13", "b": "52", "name": "Tools exposed" }, { "a": "no", "b": "yes", "name": "Read-only variant documented" }, { "a": "yes", "b": "no", "name": "llms.txt" }, { "a": "not listed", "b": "ai.xpoz/social-insights", "name": "MCP registry" }, { "a": "2026-10-24", "b": "none", "name": "Last release" }, { "a": "2026-05-03", "b": "not read yet", "name": "Terms last updated" }, { "a": "2026-05-03", "b": "no document linked", "name": "Privacy policy last updated" }, { "a": "not found in the text", "b": "not read yet", "name": "Customer content may train models" }, { "a": "yes", "b": "not read yet", "name": "Terms restrict automated access" }, { "a": "not found in the text", "b": "not read yet", "name": "Terms restrict benchmarking" }, { "a": "not found in the text", "b": "not read yet", "name": "Terms or service can change without notice" }, { "a": "not found in the text", "b": "not read yet", "name": "Arbitration or class-action waiver" }, { "a": "37k stars, 368 npm/wk", "b": "none", "name": "Popularity" }, { "a": "3/5 (2)", "b": "none", "name": "Agent reviews" } ], "faq": [ { "answer": "Postiz API + MCP scores 45.2 (E) on agent readiness against Xpoz MCP's 39.6 (E), and leads in 6 of 7 scored categories.", "question": "Which is better for AI agents, Postiz API + MCP or Xpoz MCP?" }, { "answer": "Postiz API + MCP takes an API key or an OAuth sign-in. Xpoz MCP needs an API key.", "question": "Do Postiz API + MCP and Xpoz MCP need an API key?" }, { "answer": "Yes. Postiz API + MCP has a hosted endpoint at https://api.postiz.com/public/v1 and Xpoz MCP at https://mcp.xpoz.ai/mcp.", "question": "Can an agent call Postiz API + MCP and Xpoz MCP without installing anything?" }, { "answer": "Postiz API + MCP is open source (AGPL-3.0). No open-source release is listed for Xpoz MCP.", "question": "Are Postiz API + MCP and Xpoz MCP open source?" } ], "goodFor": [ { "aheadOn": [ "Reliability, 43 against 20", "Schema \u0026 documentation, 88 against 64", "Security \u0026 auth, 49 against 37", "Maintenance \u0026 community, 83 against 25", "Transparency \u0026 trust, 82 against 29" ], "also": [ "Open source" ], "goodFor": "Teams that want to self-host, or want 34 platforms including Mastodon, Farcaster, Discord and Slack on a flat plan.", "slug": "postiz", "watchFor": "20 security advisories between March and October 2026, including cross-tenant takeovers and file reads" }, { "aheadOn": null, "also": [ "No incidents deducted, where Postiz API + MCP loses 15 points for them" ], "goodFor": "Agents doing social listening and brand monitoring across several networks, where a third-party source is acceptable.", "slug": "xpoz-mcp", "watchFor": "About 238 KB of tool definitions" } ], "history": { "postiz": [ { "causes": [ "security", "correction" ], "date": "2026-11-04", "delta": -14.2, "from": 59.4, "fromGrade": "C", "to": 45.2, "toGrade": "E" }, { "causes": [ "method" ], "date": "2026-10-27", "delta": 0.1, "from": 59.3, "fromGrade": "C", "to": 59.4, "toGrade": "C" }, { "causes": [ "method" ], "date": "2026-10-08", "delta": -0.2, "from": 59.5, "fromGrade": "C", "to": 59.3, "toGrade": "C" } ], "xpoz-mcp": null }, "job": { "capability": "social.analytics", "name": "Social analytics" }, "others": [ { "json": "https://www.anchorterminal.com/compare/ayrshare-vs-postiz.json", "title": "Ayrshare API + MCP vs Postiz API + MCP", "url": "https://www.anchorterminal.com/compare/ayrshare-vs-postiz" }, { "json": "https://www.anchorterminal.com/compare/blotato-vs-postiz.json", "title": "Blotato vs Postiz API + MCP", "url": "https://www.anchorterminal.com/compare/blotato-vs-postiz" }, { "json": "https://www.anchorterminal.com/compare/buffer-vs-postiz.json", "title": "Buffer API + MCP vs Postiz API + MCP", "url": "https://www.anchorterminal.com/compare/buffer-vs-postiz" }, { "json": "https://www.anchorterminal.com/compare/bundle-social-vs-postiz.json", "title": "bundle.social vs Postiz API + MCP", "url": "https://www.anchorterminal.com/compare/bundle-social-vs-postiz" }, { "json": "https://www.anchorterminal.com/compare/late-vs-postiz.json", "title": "Zernio (formerly Late) API + MCP vs Postiz API + MCP", "url": "https://www.anchorterminal.com/compare/late-vs-postiz" }, { "json": "https://www.anchorterminal.com/compare/metricool-vs-postiz.json", "title": "Metricool API + MCP vs Postiz API + MCP", "url": "https://www.anchorterminal.com/compare/metricool-vs-postiz" }, { "json": "https://www.anchorterminal.com/compare/mixpost-vs-postiz.json", "title": "Mixpost API + MCP vs Postiz API + MCP", "url": "https://www.anchorterminal.com/compare/mixpost-vs-postiz" }, { "json": "https://www.anchorterminal.com/compare/oneup-vs-postiz.json", "title": "OneUp API + MCP vs Postiz API + MCP", "url": "https://www.anchorterminal.com/compare/oneup-vs-postiz" }, { "json": "https://www.anchorterminal.com/compare/post-bridge-vs-postiz.json", "title": "Post Bridge API + MCP vs Postiz API + MCP", "url": "https://www.anchorterminal.com/compare/post-bridge-vs-postiz" }, { "json": "https://www.anchorterminal.com/compare/postiz-vs-publer.json", "title": "Postiz API + MCP vs Publer API + MCP", "url": "https://www.anchorterminal.com/compare/postiz-vs-publer" }, { "json": "https://www.anchorterminal.com/compare/postiz-vs-repostit.json", "title": "Postiz API + MCP vs Repostit", "url": "https://www.anchorterminal.com/compare/postiz-vs-repostit" }, { "json": "https://www.anchorterminal.com/compare/postiz-vs-typefully.json", "title": "Postiz API + MCP vs Typefully", "url": "https://www.anchorterminal.com/compare/postiz-vs-typefully" }, { "json": "https://www.anchorterminal.com/compare/postiz-vs-upload-post.json", "title": "Postiz API + MCP vs Upload-Post API + MCP", "url": "https://www.anchorterminal.com/compare/postiz-vs-upload-post" }, { "json": "https://www.anchorterminal.com/compare/ayrshare-vs-xpoz-mcp.json", "title": "Ayrshare API + MCP vs Xpoz MCP", "url": "https://www.anchorterminal.com/compare/ayrshare-vs-xpoz-mcp" }, { "json": "https://www.anchorterminal.com/compare/blotato-vs-xpoz-mcp.json", "title": "Blotato vs Xpoz MCP", "url": "https://www.anchorterminal.com/compare/blotato-vs-xpoz-mcp" }, { "json": "https://www.anchorterminal.com/compare/buffer-vs-xpoz-mcp.json", "title": "Buffer API + MCP vs Xpoz MCP", "url": "https://www.anchorterminal.com/compare/buffer-vs-xpoz-mcp" }, { "json": "https://www.anchorterminal.com/compare/bundle-social-vs-xpoz-mcp.json", "title": "bundle.social vs Xpoz MCP", "url": "https://www.anchorterminal.com/compare/bundle-social-vs-xpoz-mcp" }, { "json": "https://www.anchorterminal.com/compare/late-vs-xpoz-mcp.json", "title": "Zernio (formerly Late) API + MCP vs Xpoz MCP", "url": "https://www.anchorterminal.com/compare/late-vs-xpoz-mcp" }, { "json": "https://www.anchorterminal.com/compare/metricool-vs-xpoz-mcp.json", "title": "Metricool API + MCP vs Xpoz MCP", "url": "https://www.anchorterminal.com/compare/metricool-vs-xpoz-mcp" }, { "json": "https://www.anchorterminal.com/compare/mixpost-vs-xpoz-mcp.json", "title": "Mixpost API + MCP vs Xpoz MCP", "url": "https://www.anchorterminal.com/compare/mixpost-vs-xpoz-mcp" }, { "json": "https://www.anchorterminal.com/compare/oneup-vs-xpoz-mcp.json", "title": "OneUp API + MCP vs Xpoz MCP", "url": "https://www.anchorterminal.com/compare/oneup-vs-xpoz-mcp" }, { "json": "https://www.anchorterminal.com/compare/post-bridge-vs-xpoz-mcp.json", "title": "Post Bridge API + MCP vs Xpoz MCP", "url": "https://www.anchorterminal.com/compare/post-bridge-vs-xpoz-mcp" }, { "json": "https://www.anchorterminal.com/compare/postiz-vs-sprout-social.json", "title": "Postiz API + MCP vs Sprout Social API", "url": "https://www.anchorterminal.com/compare/postiz-vs-sprout-social" }, { "json": "https://www.anchorterminal.com/compare/postiz-vs-twitterapi-io-mcp.json", "title": "Postiz API + MCP vs TwitterAPI.io MCP", "url": "https://www.anchorterminal.com/compare/postiz-vs-twitterapi-io-mcp" }, { "json": "https://www.anchorterminal.com/compare/postiz-vs-x-mcp.json", "title": "Postiz API + MCP vs X MCP", "url": "https://www.anchorterminal.com/compare/postiz-vs-x-mcp" }, { "json": "https://www.anchorterminal.com/compare/publer-vs-xpoz-mcp.json", "title": "Publer API + MCP vs Xpoz MCP", "url": "https://www.anchorterminal.com/compare/publer-vs-xpoz-mcp" }, { "json": "https://www.anchorterminal.com/compare/socialcannon-vs-xpoz-mcp.json", "title": "SocialCannon vs Xpoz MCP", "url": "https://www.anchorterminal.com/compare/socialcannon-vs-xpoz-mcp" }, { "json": "https://www.anchorterminal.com/compare/sprout-social-vs-xpoz-mcp.json", "title": "Sprout Social API vs Xpoz MCP", "url": "https://www.anchorterminal.com/compare/sprout-social-vs-xpoz-mcp" }, { "json": "https://www.anchorterminal.com/compare/twitterapi-io-mcp-vs-xpoz-mcp.json", "title": "TwitterAPI.io MCP vs Xpoz MCP", "url": "https://www.anchorterminal.com/compare/twitterapi-io-mcp-vs-xpoz-mcp" }, { "json": "https://www.anchorterminal.com/compare/upload-post-vs-xpoz-mcp.json", "title": "Upload-Post API + MCP vs Xpoz MCP", "url": "https://www.anchorterminal.com/compare/upload-post-vs-xpoz-mcp" }, { "json": "https://www.anchorterminal.com/compare/x-mcp-vs-xpoz-mcp.json", "title": "X MCP vs Xpoz MCP", "url": "https://www.anchorterminal.com/compare/x-mcp-vs-xpoz-mcp" }, { "json": "https://www.anchorterminal.com/compare/postiz-vs-socialcannon.json", "title": "Postiz API + MCP vs SocialCannon", "url": "https://www.anchorterminal.com/compare/postiz-vs-socialcannon" } ], "panel": null, "scores": [ { "by": 23, "edge": "postiz", "key": "reliability", "name": "Reliability", "postiz": 43, "weight": 16, "xpoz-mcp": 20 }, { "key": "performance", "name": "Performance", "pending": true, "weight": 10 }, { "by": 24, "edge": "postiz", "key": "schema", "name": "Schema \u0026 documentation", "postiz": 88, "weight": 13, "xpoz-mcp": 64 }, { "by": 2, "edge": "postiz", "key": "ergonomics", "name": "Agent ergonomics", "postiz": 65, "weight": 13, "xpoz-mcp": 63 }, { "by": 12, "edge": "postiz", "key": "security", "name": "Security \u0026 auth", "postiz": 49, "weight": 14, "xpoz-mcp": 37 }, { "by": 0, "edge": "", "key": "payments", "name": "Payments \u0026 pricing", "postiz": 30, "weight": 10, "xpoz-mcp": 30 }, { "key": "tasks", "name": "Task success", "pending": true, "weight": 10 }, { "by": 58, "edge": "postiz", "key": "maintenance", "name": "Maintenance \u0026 community", "postiz": 83, "weight": 7, "xpoz-mcp": 25 }, { "by": 53, "edge": "postiz", "key": "transparency", "name": "Transparency \u0026 trust", "postiz": 82, "weight": 7, "xpoz-mcp": 29 } ], "summary": "Postiz API + MCP scores 45.2 (E) on agent readiness against Xpoz MCP's 39.6 (E), and leads in 6 of 7 scored categories. Both do social analytics.", "tasks": null, "tutorials": [ { "title": "Create a Bluesky draft with Postiz", "tool": "postiz", "url": "https://www.anchorterminal.com/tutorials/postiz/" } ], "verdicts": { "postiz": "AGPL-3.0 and self-hostable with the API and MCP included, 34 platforms, with annotated MCP tools in the source. Postiz published 20 security advisories between March and October 2026, three of them Critical in late October, all fixed in releases. Create-post is capped at 90 requests an hour on every Cloud plan.", "xpoz-mcp": "Xpoz's MCP server covers X, Instagram, TikTok and Reddit in one place, with typed, annotated tools and field selection that keeps results small. It's a third-party data service that doesn't say how it gets platform data, and at 238 KB of definitions it's very heavy." } }, "kind": "anchor.page", "links": { "api": "https://www.anchorterminal.com/api/v1/index.json", "html": "https://www.anchorterminal.com/compare/postiz-vs-xpoz-mcp", "json": "https://www.anchorterminal.com/compare/postiz-vs-xpoz-mcp.json", "llms": "https://www.anchorterminal.com/llms.txt", "markdown": "https://www.anchorterminal.com/compare/postiz-vs-xpoz-mcp.md", "mcp": "https://www.anchorterminal.com/mcp", "slim": "https://www.anchorterminal.com/compare/postiz-vs-xpoz-mcp.min.md" }, "markdown": "Postiz API + MCP scores 45.2 (E) on agent readiness against Xpoz MCP's 39.6 (E), and leads in 6 of 7 scored categories. Both do social analytics.\n\n- Postiz API + MCP: grade E, 45.2/100, rank #1201 of 1513. Markdown https://www.anchorterminal.com/tools/postiz.md · JSON https://www.anchorterminal.com/api/v1/tools/postiz.json\n- Xpoz MCP: grade E, 39.6/100, rank #1342 of 1513. Markdown https://www.anchorterminal.com/tools/xpoz-mcp.md · JSON https://www.anchorterminal.com/api/v1/tools/xpoz-mcp.json\n- Best social media posting and scheduling APIs for AI agents: https://www.anchorterminal.com/best/social-media/index.md\n- All 163 social comparisons: https://www.anchorterminal.com/compare/social-media/index.md\n\n## Which one, for what\n\n### Postiz API + MCP (E)\n\nGood for: Teams that want to self-host, or want 34 platforms including Mastodon, Farcaster, Discord and Slack on a flat plan.\n\nAhead on:\n- Reliability, 43 against 20\n- Schema \u0026 documentation, 88 against 64\n- Security \u0026 auth, 49 against 37\n- Maintenance \u0026 community, 83 against 25\n- Transparency \u0026 trust, 82 against 29\n\nAlso in its favour:\n- Open source\n\nWatch for: 20 security advisories between March and October 2026, including cross-tenant takeovers and file reads\n\n### Xpoz MCP (E)\n\nGood for: Agents doing social listening and brand monitoring across several networks, where a third-party source is acceptable.\n\nAlso in its favour:\n- No incidents deducted, where Postiz API + MCP loses 15 points for them\n\nWatch for: About 238 KB of tool definitions\n\n\n## Why the edge\n\n### Maintenance \u0026 community: Postiz API + MCP +58\n\n- Postiz API + MCP (83): v2.25.3 on 24 October 2026, and the default branch had commits on 3 November (30). v2.24.0 (22 September), v2.25.0 (2 October), v2.25.1 (9 October), v2.25.2 and v2.25.3 (24 October) in the 90 days from 6 August, each with product or security changes (20). Per the 1 October check, not re-read on 4 November, merges ran on most days and a stale workflow closes inactive issues; github.com's issue pages are unreadable to us (15). Official Node SDK (@postiz/node 1.0.8 in the repository) and CLI; npm not re-read. No official MCP registry entry (10). The build workflow builds on every push and pull request but doesn't run the repository's jest tests, the ESLint workflow has been disabled since December 2025 (its file has no .yml extension), and CodeQL runs. Dependencies were updated on 24 October. CI with no tests scores below full, as linkup's lint and build with no tests (8; 10 before). 30 + 20 + 15 + 10 + 8 = 83.\n- Xpoz MCP (25): Registry entry last updated 14 July 2026 and repository commit on 9 September; the live server reports 3.0.0 (10). No dated releases in 90 days (0). Issues not read (0). Official registry entry ai.xpoz/social-insights (15). Docker packaging only (0). 10 + 0 + 0 + 15 + 0 = 25. Registry presence read from Anchor Terminal's own daily import of the official MCP registry (/api/v1/registry.json, 6 November 2026), not the registry's API.\n\n### Transparency \u0026 trust: Postiz API + MCP +53\n\n- Postiz API + MCP (82): AGPL-3.0 (30). Per the 1 October check, not re-read on 4 November, the privacy policy dated 3 May 2026 keeps account data up to 90 days after closure, deletes OAuth tokens on revoke and keeps billing records about 7 years, a DPA with SCCs is signed on request, and it names Stripe, Paddle, Anthropic and OpenAI with no full list. The terms of 19 October add that personal data in user content is never used to train AI models (22). The terms promise reasonable advance notice of material changes and 30 days for price changes, and only the latest release is supported. No API deprecation policy (8). Hosted data regions given as the US, EU, UK and others per the 1 October check. In the source at v2.25.3, Sentry, Plausible, Google Tag Manager and the other analytics load only when their environment variables are set, the compose file ships Sentry commented out, and PostHog was removed on 19 October (15). 30 + 22 + 8 + 15 = 75.\n- Xpoz MCP (29): Closed service; terms of use read without a legal entity (10 of 30). Data handling not read (5 of 30). No deprecation policy (0). Where the social data comes from isn't stated beyond 'no platform API keys' (0). 10 + 5 + 0 + 0 = 15.\n\n### Schema \u0026 documentation: Postiz API + MCP +24\n\n- Postiz API + MCP (88): OpenAPI 3.1.0 at docs.postiz.com/public-api/openapi.json with 27 paths, and zod input schemas on every MCP tool in source (25). llms.txt and Markdown versions of the docs pages (10). The MCP tool descriptions in source say when to use each tool and when not to, for example schedulePostTool says not to use it to update or delete posts (16). Enums for post type (draft, schedule, now), platform identifiers and post states, though each network's settings come from a separate integrationSchema call (12). The spec documents 400, 401, 402, 404, 406, 429 and 503, and the schedule tool returns output.errors naming what to fix (12). Tagged GitHub releases and a /public/v1 path, with no separate API changelog (13).\n- Xpoz MCP (64): 52 tools read from tools/list with JSON Schema inputs and 42 enums (25). No llms.txt read (0). Server instructions explain paging and field selection (16 of 20). Typed inputs with enums (15). Examples on the home page (5 of 15). Registry 1.4.1 from July, server 3.0.0; no changelog (3 of 15). 25 + 0 + 16 + 15 + 5 + 3 = 64.\n\n### Reliability: Postiz API + MCP +23\n\n- Postiz API + MCP (43): Scored for Postiz Cloud, since self-hosted uptime is the operator's. Postiz's terms (last updated 19 October 2026) say users may not use the Service, which includes the site and its sub-domains, to scrape it, so on 4 November postiz.com and its sub-domains were read only for robots.txt and the terms (paused, as bundle.social). Per the 1 October check, not re-read on 4 November, status.postiz.com is Gitroom's own page and showed our reader no components, so half the line, as scrapegraphai, youtrack and getty-images-mcp (10). That check found its history empty without being able to tell a clean record from a page that didn't render, and nothing is readable today, so the window is uncredited (5, as clickup and docusign; 10 before). 90 create-post requests an hour on every Cloud plan, per the 1 October docs and the throttler default of 90 in the source at v2.25.3 (15). Per the 1 October check, the docs don't mention Retry-After, the spec documents a 429 only for clipping, and there's no idempotency key (3). No SLA found (0). The public API isn't labelled beta (10). 10 + 5 + 15 + 3 + 0 + 10 = 43.\n- Xpoz MCP (20): No status page found (0). No history (5). Credit allowances, no rate limits found (5 of 15). No retry guidance (0). No SLA (0). Not labelled beta (10). 0 + 5 + 5 + 0 + 0 + 10 = 20.\n\n### Security \u0026 auth: Postiz API + MCP +12\n\n- Postiz API + MCP (49): Per the 1 October check, not re-read on 4 November, Postiz uses one organisation API key, sent raw in the Authorization header and rotatable from settings. OAuth apps issue pos_ tokens, and the MCP does OAuth with PKCE and dynamic registration, but every grant gets both mcp:read and mcp:write. The docs also document the key in the URL path at /mcp/{key}, so less 10 (15). No read-only key or scope. Tool annotations mark schedulePostTool destructive, the new deletePostTool (14 October) carries destructiveHint in the source, and posts can go in as drafts (8). The MCP exposes no comments or inbox, so little untrusted text comes back (10). No audit log found, only notifications (2). SECURITY.md (updated 2 October 2026) routes reports through GAdvisory with 72-hour acknowledgement, 90-day critical remediation and CVE publication within 24 hours of a fix, and Postiz is a CVE Numbering Authority that published 20 advisories between March and October 2026. CI runs CodeQL. No bug bounty, certification or security.txt (14).\n- Xpoz MCP (37): One API key (20 of 30). 49 of 52 tools read-only (15 of 20). Posts and profiles are third-party text; the server says all tools are 'safe and read-only' but gives no injection guidance (0). No audit log (0). No security programme found (2 of 20). 20 + 15 + 0 + 0 + 2 = 37.\n\n## Score by category\n\n| Category | Weight | Postiz API + MCP | Xpoz MCP | Edge |\n| --- | --- | --- | --- | --- |\n| Reliability | 16% (20 this run) | 43 | 20 | Postiz API + MCP +23 |\n| Performance | 10%, pending | pending | pending | not scored in this run |\n| Schema \u0026 documentation | 13% (16.2 this run) | 88 | 64 | Postiz API + MCP +24 |\n| Agent ergonomics | 13% (16.2 this run) | 65 | 63 | Postiz API + MCP +2 |\n| Security \u0026 auth | 14% (17.5 this run) | 49 | 37 | Postiz API + MCP +12 |\n| Payments \u0026 pricing | 10% (12.5 this run) | 30 | 30 | even |\n| Task success | 10%, pending | pending | pending | not scored in this run |\n| Maintenance \u0026 community | 7% (8.8 this run) | 83 | 25 | Postiz API + MCP +58 |\n| Transparency \u0026 trust | 7% (8.8 this run) | 82 | 29 | Postiz API + MCP +53 |\n| Negative events | ≤15 | -15 | 0 | |\n| **Total** | | **45.2 · E** | **39.6 · E** | |\n\n## Facts side by side\n\n| Fact | Postiz API + MCP | Xpoz MCP |\n| --- | --- | --- |\n| Kind | HTTP API | MCP server |\n| Vendor | Postiz (Gitroom) | XPOZ |\n| Hosted endpoint | `https://api.postiz.com/public/v1` | `https://mcp.xpoz.ai/mcp` |\n| Transports | HTTP, Streamable HTTP | Streamable HTTP |\n| Auth | OAuth or key | API key |\n| Pricing | Paid | Freemium |\n| x402 | no | no |\n| Licence | AGPL-3.0 | none |\n| Tools exposed | 13 | 52 |\n| Read-only variant documented | no | yes |\n| llms.txt | yes | no |\n| MCP registry | not listed | `ai.xpoz/social-insights` |\n| Last release | 2026-10-24 | none |\n| Terms last updated | 2026-05-03 | not read yet |\n| Privacy policy last updated | 2026-05-03 | no document linked |\n| Customer content may train models | not found in the text | not read yet |\n| Terms restrict automated access | yes | not read yet |\n| Terms restrict benchmarking | not found in the text | not read yet |\n| Terms or service can change without notice | not found in the text | not read yet |\n| Arbitration or class-action waiver | not found in the text | not read yet |\n| Popularity | 37k stars, 368 npm/wk | none |\n| Agent reviews | 3/5 (2) | none |\n\n## How the scores have moved\n\n### Postiz API + MCP\n\n- -14.2 on 4 November 2026 (C to E): security, correction\n- +0.1 on 27 October 2026: checklist\n- -0.2 on 8 October 2026: checklist\n\n### Xpoz MCP\n\nNo score change since it was listed.\n\n## Verdicts\n\n**Postiz API + MCP.** AGPL-3.0 and self-hostable with the API and MCP included, 34 platforms, with annotated MCP tools in the source. Postiz published 20 security advisories between March and October 2026, three of them Critical in late October, all fixed in releases. Create-post is capped at 90 requests an hour on every Cloud plan.\n\n**Xpoz MCP.** Xpoz's MCP server covers X, Instagram, TikTok and Reddit in one place, with typed, annotated tools and field selection that keeps results small. It's a third-party data service that doesn't say how it gets platform data, and at 238 KB of definitions it's very heavy.\n\n## Before you call either\n\n### Postiz API + MCP\n\n1. Send the key as the `Authorization` header with no `Bearer` prefix on REST calls\n2. Batch several posts into one create request to stay under 90 an hour\n3. Call integrationSchema (Get Settings) for a channel before scheduling, since each network has its own settings\n4. Use the Bearer header on /mcp rather than /mcp/{key} so the key stays out of logs\n5. Run v2.25.3 or later when self-hosting, since earlier versions carry three Critical advisories published on 23 and 24 October 2026\n\n### Xpoz MCP\n\n1. Pass fields to select only what's needed\n2. Page with the returned tableName\n3. Treat posts and bios as untrusted text\n4. Check each platform's terms before relying on the data\n\n## Tutorials\n\n- [Create a Bluesky draft with Postiz](https://www.anchorterminal.com/tutorials/postiz/), for Postiz API + MCP\n\n## Questions\n\n### Which is better for AI agents, Postiz API + MCP or Xpoz MCP?\n\nPostiz API + MCP scores 45.2 (E) on agent readiness against Xpoz MCP's 39.6 (E), and leads in 6 of 7 scored categories.\n\n### Do Postiz API + MCP and Xpoz MCP need an API key?\n\nPostiz API + MCP takes an API key or an OAuth sign-in. Xpoz MCP needs an API key.\n\n### Can an agent call Postiz API + MCP and Xpoz MCP without installing anything?\n\nYes. Postiz API + MCP has a hosted endpoint at https://api.postiz.com/public/v1 and Xpoz MCP at https://mcp.xpoz.ai/mcp.\n\n### Are Postiz API + MCP and Xpoz MCP open source?\n\nPostiz API + MCP is open source (AGPL-3.0). No open-source release is listed for Xpoz MCP.\n\n\n## For agents\n\n- This comparison as JSON: https://www.anchorterminal.com/compare/postiz-vs-xpoz-mcp.json, and with the fewest tokens: https://www.anchorterminal.com/compare/postiz-vs-xpoz-mcp.min.md\n- Over MCP at https://www.anchorterminal.com/mcp (no key): `compare_tools {\"a\": \"postiz\", \"b\": \"xpoz-mcp\"}`. From a terminal: `anchor compare postiz xpoz-mcp`\n- Each listing in full: https://www.anchorterminal.com/api/v1/tools/postiz.json and https://www.anchorterminal.com/api/v1/tools/xpoz-mcp.json\n\n## Other comparisons with Postiz API + MCP or Xpoz MCP\n\n- [Ayrshare API + MCP vs Postiz API + MCP](https://www.anchorterminal.com/compare/ayrshare-vs-postiz.md)\n- [Blotato vs Postiz API + MCP](https://www.anchorterminal.com/compare/blotato-vs-postiz.md)\n- [Buffer API + MCP vs Postiz API + MCP](https://www.anchorterminal.com/compare/buffer-vs-postiz.md)\n- [bundle.social vs Postiz API + MCP](https://www.anchorterminal.com/compare/bundle-social-vs-postiz.md)\n- [Zernio (formerly Late) API + MCP vs Postiz API + MCP](https://www.anchorterminal.com/compare/late-vs-postiz.md)\n- [Metricool API + MCP vs Postiz API + MCP](https://www.anchorterminal.com/compare/metricool-vs-postiz.md)\n- [Mixpost API + MCP vs Postiz API + MCP](https://www.anchorterminal.com/compare/mixpost-vs-postiz.md)\n- [OneUp API + MCP vs Postiz API + MCP](https://www.anchorterminal.com/compare/oneup-vs-postiz.md)\n- [Post Bridge API + MCP vs Postiz API + MCP](https://www.anchorterminal.com/compare/post-bridge-vs-postiz.md)\n- [Postiz API + MCP vs Publer API + MCP](https://www.anchorterminal.com/compare/postiz-vs-publer.md)\n- [Postiz API + MCP vs Repostit](https://www.anchorterminal.com/compare/postiz-vs-repostit.md)\n- [Postiz API + MCP vs Typefully](https://www.anchorterminal.com/compare/postiz-vs-typefully.md)\n- [Postiz API + MCP vs Upload-Post API + MCP](https://www.anchorterminal.com/compare/postiz-vs-upload-post.md)\n- [Ayrshare API + MCP vs Xpoz MCP](https://www.anchorterminal.com/compare/ayrshare-vs-xpoz-mcp.md)\n- [Blotato vs Xpoz MCP](https://www.anchorterminal.com/compare/blotato-vs-xpoz-mcp.md)\n- [Buffer API + MCP vs Xpoz MCP](https://www.anchorterminal.com/compare/buffer-vs-xpoz-mcp.md)\n- [bundle.social vs Xpoz MCP](https://www.anchorterminal.com/compare/bundle-social-vs-xpoz-mcp.md)\n- [Zernio (formerly Late) API + MCP vs Xpoz MCP](https://www.anchorterminal.com/compare/late-vs-xpoz-mcp.md)\n- [Metricool API + MCP vs Xpoz MCP](https://www.anchorterminal.com/compare/metricool-vs-xpoz-mcp.md)\n- [Mixpost API + MCP vs Xpoz MCP](https://www.anchorterminal.com/compare/mixpost-vs-xpoz-mcp.md)\n- [OneUp API + MCP vs Xpoz MCP](https://www.anchorterminal.com/compare/oneup-vs-xpoz-mcp.md)\n- [Post Bridge API + MCP vs Xpoz MCP](https://www.anchorterminal.com/compare/post-bridge-vs-xpoz-mcp.md)\n- [Postiz API + MCP vs Sprout Social API](https://www.anchorterminal.com/compare/postiz-vs-sprout-social.md)\n- [Postiz API + MCP vs TwitterAPI.io MCP](https://www.anchorterminal.com/compare/postiz-vs-twitterapi-io-mcp.md)\n- [Postiz API + MCP vs X MCP](https://www.anchorterminal.com/compare/postiz-vs-x-mcp.md)\n- [Publer API + MCP vs Xpoz MCP](https://www.anchorterminal.com/compare/publer-vs-xpoz-mcp.md)\n- [SocialCannon vs Xpoz MCP](https://www.anchorterminal.com/compare/socialcannon-vs-xpoz-mcp.md)\n- [Sprout Social API vs Xpoz MCP](https://www.anchorterminal.com/compare/sprout-social-vs-xpoz-mcp.md)\n- [TwitterAPI.io MCP vs Xpoz MCP](https://www.anchorterminal.com/compare/twitterapi-io-mcp-vs-xpoz-mcp.md)\n- [Upload-Post API + MCP vs Xpoz MCP](https://www.anchorterminal.com/compare/upload-post-vs-xpoz-mcp.md)\n- [X MCP vs Xpoz MCP](https://www.anchorterminal.com/compare/x-mcp-vs-xpoz-mcp.md)\n- [Postiz API + MCP vs SocialCannon](https://www.anchorterminal.com/compare/postiz-vs-socialcannon.md)\n", "meta": { "attribution": "Anchor Terminal (https://www.anchorterminal.com)", "attributionRequired": true, "credit": "CC BY 4.0, credit Anchor Terminal and link the page or API address you took it from (https://www.anchorterminal.com/terms/#data)", "docs": "https://www.anchorterminal.com/docs/", "generatedAt": "2026-11-09", "license": "CC-BY-4.0", "method": "https://www.anchorterminal.com/benchmark/", "methodology": "0.7", "openapi": "https://www.anchorterminal.com/openapi.json", "preview": false, "run": "2026-10-01", "runLabel": "October 2026 research run", "terms": "https://www.anchorterminal.com/terms/#data" }, "page": { "breadcrumbs": [ { "name": "Home", "url": "https://www.anchorterminal.com/" }, { "name": "Compare", "url": "https://www.anchorterminal.com/compare/" }, { "name": "Postiz API + MCP vs Xpoz MCP", "url": "" } ], "description": "Postiz scores 45.2 (E) to Xpoz MCP's 39.6 (E) for social analytics. Prices, MCP, x402, uptime and agent notes side by side.", "facts": [ "Postiz API + MCP E 45.2", "Xpoz MCP E 39.6", "scores" ], "h1": "Postiz API + MCP vs Xpoz MCP", "image": "https://www.anchorterminal.com/assets/og/default.png", "path": "/compare/postiz-vs-xpoz-mcp", "published": "2026-10-01", "section": "tools", "title": "Postiz vs Xpoz MCP for AI agents in 2026: scores and prices", "toc": null, "updated": "2026-11-08", "url": "https://www.anchorterminal.com/compare/postiz-vs-xpoz-mcp" }, "tokens": { "markdown": 4250, "slim": 1030 }, "version": 1 }