MCP Server
Last updated

MCP Server

VwD exposes an MCP (Model Context Protocol) server that lets AI assistants query your creator data, compliance reports, and brand safety insights directly.

Endpoint: https://api.vwd.ai/mcp/

Supported clients: Claude.ai, Claude Code, Claude Desktop, Cursor, VS Code, Windsurf, ChatGPT, and any MCP-compatible client.

Quick Start

Claude.ai (Web / Desktop / Mobile)

  1. Go to Settings → Connectors in Claude.ai.
  2. Add a new connector with URL: https://api.vwd.ai/mcp/
  3. Complete the OAuth consent flow when prompted.
  4. Ask Claude to use your VwD data — e.g., "List my organizations" or "Search for creators in Europe".

Claude Code (CLI)

claude mcp add --transport http vwd https://api.vwd.ai/mcp/

Then run /mcp in Claude Code to authenticate.

Cursor

Add to your MCP settings (.cursor/mcp.json):

{
  "mcpServers": {
    "vwd": {
      "url": "https://api.vwd.ai/mcp/"
    }
  }
}

VS Code

Add to your VS Code settings (.vscode/mcp.json):

{
  "servers": {
    "vwd": {
      "type": "http",
      "url": "https://api.vwd.ai/mcp/"
    }
  }
}

ChatGPT

Requires a Plus, Pro, Team, Enterprise, or Edu plan.

  1. Open ChatGPT and go to Settings → Connectors.
  2. Click Advanced at the bottom and enable Developer mode.
  3. Click Add custom connector and enter the URL: https://api.vwd.ai/mcp/
  4. Complete the OAuth consent flow when prompted.
  5. In a new chat, click + → More → enable your VwD connector.
  6. Start querying — e.g., "List my VwD organizations" or "Search for creators on Instagram".

Authentication

The MCP server uses OAuth 2.0 with PKCE. Authentication is handled automatically by your MCP client:

  1. Your client discovers the OAuth endpoints via /.well-known/oauth-authorization-server.
  2. It registers via Dynamic Client Registration (DCR).
  3. You're redirected to VwD to log in and grant consent.
  4. Your client receives an access token and refreshes it automatically.

No API keys or manual token management needed.

Prerequisites

  • A VwD account with access to at least one organization.
  • MCP must be enabled for your organization (contact your admin or support@vwd.ai).

Available Tools

Once connected, your AI assistant can use these 16 tools:

Organizations

ToolDescription
list_organizationsList all organizations the authenticated user has access to.

Creators

ToolDescription
list_creatorsList all creators in an organization with paginated results.
get_creatorGet the full profile for a single creator.
search_creatorsSearch creators using structured attribute filters (database query).
search_creators_fulltextFull-text keyword search across creator post content using Elasticsearch.

Posts & Timeline

ToolDescription
get_creator_postsGet posts for a creator, filterable by year, platform, and brand.
get_creator_timelineGet a creator's posting timeline grouped by year-month periods.
get_post_brandsGet brands detected in a specific post with detection reasons.
search_posts_fulltextFull-text keyword search across post content via Elasticsearch.

Brands

ToolDescription
find_brandSearch for brands by name (case-insensitive substring match).
get_creator_brand_timelineGet a timeline of brand mentions for a creator, grouped by period.
get_creator_brand_postsGet posts where a specific brand was detected for a creator.

Lists

ToolDescription
list_creator_listsList all creator lists in the organization.
get_creator_listGet a specific list with its creators and full profile data.

Compliance

ToolDescription
get_creator_compliance_timelineGet compliance issue timeline for a creator, grouped by period.
get_creator_compliance_postsGet posts with compliance violations for a creator.

Usage Examples

"Show me creators in my organization"

List all creators in my organization and show their platforms.

"Find brand mentions"

Search for posts mentioning Nike from creators in my organization.

"Check compliance"

Show me the compliance timeline for creator ID 12345.

"Search across posts"

Search posts for content about cryptocurrency promotions.

"Brand safety analysis"

Get the brand mention timeline for creator 12345 and identify any compliance issues.

Rate Limits

MCP access is rate-limited per organization:

LimitDefault
Requests per minute120
Requests per day10,000

Contact support@vwd.ai to adjust limits for your organization.

Technical Details

OAuth Endpoints

EndpointURL
Protected Resource Metadata/.well-known/oauth-protected-resource
Authorization Server Metadata/.well-known/oauth-authorization-server
Dynamic Client RegistrationPOST /oauth/register/
AuthorizationGET /oauth/authorize/
Token ExchangePOST /oauth/token/

Protocol

  • Transport: Streamable HTTP (POST for JSON-RPC, GET for OAuth discovery)
  • Auth: OAuth 2.0 with PKCE (S256), DCR for client registration
  • Format: JSON-RPC 2.0
  • Scopes: mcp:read (read-only access)
  • Token lifetime: 1 hour (auto-refreshed by clients)

Troubleshooting

"Authorization with the MCP server failed"

  • Ensure your VwD account has MCP enabled. Contact your organization admin or support@vwd.ai.
  • Try removing and re-adding the connector in your MCP client.
  • If using Claude Code, run /mcp to re-authenticate.

"Organization not found or access denied"

  • MCP must be enabled for your organization. Contact your admin or support@vwd.ai.
  • You must be a member of the organization.

"Rate limit exceeded"

  • Default: 120 requests/minute, 10,000/day per organization.
  • Contact support@vwd.ai to increase limits.

Connection issues

  • Verify the endpoint URL: https://api.vwd.ai/mcp/ (with or without trailing slash).
  • Check that your client supports OAuth 2.0 with PKCE.

Questions?

Reach out to support@vwd.ai for access, configuration help, or to report issues.

 
Next page