{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"MCP Server","description":"Empower your business with AI-driven insights on creator compliance and brand safety through VwD's comprehensive API."},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"mcp-server"},"children":["MCP Server"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["VwD exposes an ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://modelcontextprotocol.io/"},"children":["MCP"]}," (Model Context Protocol) server that lets AI assistants query your creator data, compliance reports, and brand safety insights directly."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Endpoint:"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://api.vwd.ai/mcp/"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Supported clients:"]}," Claude.ai, Claude Code, Claude Desktop, Cursor, VS Code, Windsurf, ChatGPT, and any MCP-compatible client."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"quick-start"},"children":["Quick Start"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"claude.ai-web-/-desktop-/-mobile"},"children":["Claude.ai (Web / Desktop / Mobile)"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Go to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Settings → Connectors"]}," in Claude.ai."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Add a new connector with URL: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://api.vwd.ai/mcp/"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Complete the OAuth consent flow when prompted."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Ask Claude to use your VwD data — e.g., ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["\"List my organizations\""]}," or ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["\"Search for creators in Europe\""]},"."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"claude-code-cli"},"children":["Claude Code (CLI)"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"claude mcp add --transport http vwd https://api.vwd.ai/mcp/\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Then run ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/mcp"]}," in Claude Code to authenticate."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"cursor"},"children":["Cursor"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Add to your MCP settings (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":[".cursor/mcp.json"]},"):"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"mcpServers\": {\n    \"vwd\": {\n      \"url\": \"https://api.vwd.ai/mcp/\"\n    }\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"vs-code"},"children":["VS Code"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Add to your VS Code settings (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":[".vscode/mcp.json"]},"):"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"servers\": {\n    \"vwd\": {\n      \"type\": \"http\",\n      \"url\": \"https://api.vwd.ai/mcp/\"\n    }\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"chatgpt"},"children":["ChatGPT"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Requires a Plus, Pro, Team, Enterprise, or Edu plan."]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Open ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://chatgpt.com/"},"children":["ChatGPT"]}," and go to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Settings → Connectors"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Advanced"]}," at the bottom and enable ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Developer mode"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Add custom connector"]}," and enter the URL: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://api.vwd.ai/mcp/"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Complete the OAuth consent flow when prompted."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In a new chat, click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["+"]}," → ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["More"]}," → enable your VwD connector."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Start querying — e.g., ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["\"List my VwD organizations\""]}," or ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["\"Search for creators on Instagram\""]},"."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"authentication"},"children":["Authentication"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The MCP server uses ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["OAuth 2.0"]}," with PKCE. Authentication is handled automatically by your MCP client:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Your client discovers the OAuth endpoints via ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/.well-known/oauth-authorization-server"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["It registers via Dynamic Client Registration (DCR)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["You're redirected to VwD to log in and grant consent."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Your client receives an access token and refreshes it automatically."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["No API keys or manual token management needed."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"prerequisites"},"children":["Prerequisites"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A VwD account with access to at least one organization."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["MCP must be enabled for your organization (contact your admin or support@vwd.ai)."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"available-tools"},"children":["Available Tools"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Once connected, your AI assistant can use these 16 tools:"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"organizations"},"children":["Organizations"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Tool"},"children":["Tool"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["list_organizations"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["List all organizations the authenticated user has access to."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"creators"},"children":["Creators"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Tool"},"children":["Tool"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["list_creators"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["List all creators in an organization with paginated results."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["get_creator"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Get the full profile for a single creator."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["search_creators"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Search creators using structured attribute filters (database query)."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["search_creators_fulltext"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Full-text keyword search across creator post content using Elasticsearch."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"posts--timeline"},"children":["Posts & Timeline"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Tool"},"children":["Tool"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["get_creator_posts"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Get posts for a creator, filterable by year, platform, and brand."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["get_creator_timeline"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Get a creator's posting timeline grouped by year-month periods."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["get_post_brands"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Get brands detected in a specific post with detection reasons."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["search_posts_fulltext"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Full-text keyword search across post content via Elasticsearch."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"brands"},"children":["Brands"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Tool"},"children":["Tool"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["find_brand"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Search for brands by name (case-insensitive substring match)."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["get_creator_brand_timeline"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Get a timeline of brand mentions for a creator, grouped by period."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["get_creator_brand_posts"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Get posts where a specific brand was detected for a creator."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"lists"},"children":["Lists"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Tool"},"children":["Tool"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["list_creator_lists"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["List all creator lists in the organization."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["get_creator_list"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Get a specific list with its creators and full profile data."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"compliance"},"children":["Compliance"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Tool"},"children":["Tool"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["get_creator_compliance_timeline"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Get compliance issue timeline for a creator, grouped by period."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["get_creator_compliance_posts"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Get posts with compliance violations for a creator."]}]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"usage-examples"},"children":["Usage Examples"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"show-me-creators-in-my-organization"},"children":["\"Show me creators in my organization\""]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"List all creators in my organization and show their platforms.\n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"find-brand-mentions"},"children":["\"Find brand mentions\""]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"Search for posts mentioning Nike from creators in my organization.\n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"check-compliance"},"children":["\"Check compliance\""]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"Show me the compliance timeline for creator ID 12345.\n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"search-across-posts"},"children":["\"Search across posts\""]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"Search posts for content about cryptocurrency promotions.\n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"brand-safety-analysis"},"children":["\"Brand safety analysis\""]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"Get the brand mention timeline for creator 12345 and identify any compliance issues.\n"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"rate-limits"},"children":["Rate Limits"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["MCP access is rate-limited per organization:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Limit"},"children":["Limit"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Default"},"children":["Default"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Requests per minute"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["120"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Requests per day"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["10,000"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Contact support@vwd.ai to adjust limits for your organization."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"technical-details"},"children":["Technical Details"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"oauth-endpoints"},"children":["OAuth Endpoints"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Endpoint"},"children":["Endpoint"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"URL"},"children":["URL"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Protected Resource Metadata"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/.well-known/oauth-protected-resource"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Authorization Server Metadata"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/.well-known/oauth-authorization-server"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Dynamic Client Registration"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /oauth/register/"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Authorization"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /oauth/authorize/"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Token Exchange"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /oauth/token/"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"protocol"},"children":["Protocol"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Transport:"]}," Streamable HTTP (POST for JSON-RPC, GET for OAuth discovery)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Auth:"]}," OAuth 2.0 with PKCE (S256), DCR for client registration"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Format:"]}," JSON-RPC 2.0"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Scopes:"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["mcp:read"]}," (read-only access)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Token lifetime:"]}," 1 hour (auto-refreshed by clients)"]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"troubleshooting"},"children":["Troubleshooting"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"authorization-with-the-mcp-server-failed"},"children":["\"Authorization with the MCP server failed\""]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Ensure your VwD account has MCP enabled. Contact your organization admin or support@vwd.ai."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Try removing and re-adding the connector in your MCP client."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If using Claude Code, run ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/mcp"]}," to re-authenticate."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"organization-not-found-or-access-denied"},"children":["\"Organization not found or access denied\""]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["MCP must be enabled for your organization. Contact your admin or support@vwd.ai."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["You must be a member of the organization."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"rate-limit-exceeded"},"children":["\"Rate limit exceeded\""]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Default: 120 requests/minute, 10,000/day per organization."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Contact support@vwd.ai to increase limits."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"connection-issues"},"children":["Connection issues"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Verify the endpoint URL: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://api.vwd.ai/mcp/"]}," (with or without trailing slash)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Check that your client supports OAuth 2.0 with PKCE."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"questions"},"children":["Questions?"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Reach out to ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"mailto:support@vwd.ai"},"children":["support@vwd.ai"]}," for access, configuration help, or to report issues."]}]},"headings":[{"value":"MCP Server","id":"mcp-server","depth":1},{"value":"Quick Start","id":"quick-start","depth":2},{"value":"Claude.ai (Web / Desktop / Mobile)","id":"claude.ai-web-/-desktop-/-mobile","depth":3},{"value":"Claude Code (CLI)","id":"claude-code-cli","depth":3},{"value":"Cursor","id":"cursor","depth":3},{"value":"VS Code","id":"vs-code","depth":3},{"value":"ChatGPT","id":"chatgpt","depth":3},{"value":"Authentication","id":"authentication","depth":2},{"value":"Prerequisites","id":"prerequisites","depth":3},{"value":"Available Tools","id":"available-tools","depth":2},{"value":"Organizations","id":"organizations","depth":3},{"value":"Creators","id":"creators","depth":3},{"value":"Posts & Timeline","id":"posts--timeline","depth":3},{"value":"Brands","id":"brands","depth":3},{"value":"Lists","id":"lists","depth":3},{"value":"Compliance","id":"compliance","depth":3},{"value":"Usage Examples","id":"usage-examples","depth":2},{"value":"\"Show me creators in my organization\"","id":"show-me-creators-in-my-organization","depth":3},{"value":"\"Find brand mentions\"","id":"find-brand-mentions","depth":3},{"value":"\"Check compliance\"","id":"check-compliance","depth":3},{"value":"\"Search across posts\"","id":"search-across-posts","depth":3},{"value":"\"Brand safety analysis\"","id":"brand-safety-analysis","depth":3},{"value":"Rate Limits","id":"rate-limits","depth":2},{"value":"Technical Details","id":"technical-details","depth":2},{"value":"OAuth Endpoints","id":"oauth-endpoints","depth":3},{"value":"Protocol","id":"protocol","depth":3},{"value":"Troubleshooting","id":"troubleshooting","depth":2},{"value":"\"Authorization with the MCP server failed\"","id":"authorization-with-the-mcp-server-failed","depth":3},{"value":"\"Organization not found or access denied\"","id":"organization-not-found-or-access-denied","depth":3},{"value":"\"Rate limit exceeded\"","id":"rate-limit-exceeded","depth":3},{"value":"Connection issues","id":"connection-issues","depth":3},{"value":"Questions?","id":"questions","depth":2}],"frontmatter":{"title":"MCP Server","description":"Connect Claude, ChatGPT, Cursor, and other AI assistants to VwD using the Model Context Protocol.","seo":{"title":"MCP Server"}},"lastModified":"2026-06-15T07:03:55.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/docs/mcp","userData":{"isAuthenticated":false,"teams":["anonymous"]}}