{
  "name": "DASHR MCP Server — 🇬🇷 Greece",
  "version": "1.5.0",
  "country": "GR",
  "country_name": "Greece",
  "description": "Public read-only MCP server for the Greek social media & business intelligence database. NOT just TikTok — this is a MULTI-PLATFORM intelligence tool. 2,600+ Greek accounts (influencers, media, politicians, brands, podcasts). DATA PER ACCOUNT: TikTok (followers, engagement, views, posts), Instagram (followers, posts, engagement rate, avg likes/comments), Facebook Page (followers, category, recent posts with reactions, email, website), YouTube (subscribers, views, videos), LinkedIn (followers, employees, industry). FOR BRANDS: company financials from GEMI (revenue, profit, assets, equity — iXBRL/PDF), Meta Ads (active campaigns, reach, demographics, payer, creatives from Facebook Ad Library), media campaigns (TV + digital tracking), brand news with sentiment, SimilarWeb website traffic, Diavgeia public decisions, board of directors. ALSO: Google Trends, X/Twitter Trends (hourly), live stream monitoring, ad tracking. Use get_creator to get ALL data for any account. Use get_ad_intelligence for Meta/Facebook ads. Use get_media_campaigns for TV/digital ad campaigns.",
  "protocol": "MCP Streamable HTTP (JSON-RPC 2.0 over HTTP POST)",
  "endpoint": "https://dashr.live/mcp",
  "discovery": "https://dashr.live/.well-known/mcp.json",
  "all_endpoints": {
    "GR": "https://dashr.live/mcp",
    "CZ": "https://dashr.live/mcp-cz",
    "AT": "https://dashr.live/mcp-at",
    "UK": "https://dashr.live/mcp-uk"
  },
  "usage": {
    "method": "POST",
    "content_type": "application/json",
    "accept": "application/json, text/event-stream",
    "authentication": {
      "required_for": "All tools EXCEPT get_capabilities, get_categories, get_stats",
      "method": "Pass token via the `x-dashr-token` HTTP header or `?token=` query param",
      "get_token": "https://dashr.live/account/mcp",
      "grace_period_until": "2026-06-30T00:00:00.000Z",
      "enforcement_active": false,
      "notes": "During the grace period (until 2026-06-04) calls without a valid token succeed but include a deprecation warning. After that date, gated tools return error -32001."
    },
    "example_init": {
      "jsonrpc": "2.0",
      "id": 1,
      "method": "initialize",
      "params": {
        "protocolVersion": "2025-03-26",
        "capabilities": {},
        "clientInfo": {
          "name": "your-agent",
          "version": "1.0"
        }
      }
    }
  },
  "tools": [
    {
      "name": "search_creators",
      "description": "Search Greek accounts across TikTok, Instagram, Facebook, YouTube, LinkedIn (matches username, display name, bio, category). Use include_non_tiktok=true to include non-TikTok accounts.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "query": {
            "type": "string",
            "minLength": 2,
            "description": "Search keyword"
          },
          "limit": {
            "type": "integer",
            "minimum": 1,
            "maximum": 50,
            "default": 20,
            "description": "Max results"
          },
          "include_non_tiktok": {
            "type": "boolean",
            "default": false,
            "description": "Include non-TikTok accounts (Instagram-only, YouTube-only, etc)"
          }
        },
        "required": [
          "query"
        ]
      }
    },
    {
      "name": "get_creator",
      "description": "Get full multi-platform profile: TikTok + Instagram + Facebook + YouTube + LinkedIn + company financials + Meta Ads + brand news",
      "inputSchema": {
        "type": "object",
        "properties": {
          "username": {
            "type": "string",
            "minLength": 1,
            "description": "Username (without @ prefix) — works for TikTok, Instagram, Facebook, any platform"
          }
        },
        "required": [
          "username"
        ]
      }
    },
    {
      "name": "list_creators",
      "description": "List and filter Greek accounts (multi-platform) by category, tier, engagement, followers, with sorting. Use include_non_tiktok=true to include non-TikTok accounts.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "sort": {
            "type": "string",
            "enum": [
              "followers",
              "engagement",
              "avg_views",
              "total_likes",
              "growth"
            ],
            "default": "followers"
          },
          "limit": {
            "type": "integer",
            "minimum": 1,
            "maximum": 100,
            "default": 20
          },
          "category": {
            "type": "string",
            "description": "e.g. Food, Comedy, Travel, Beauty"
          },
          "account_type": {
            "type": "string",
            "description": "e.g. influencer, brand, podcast, politician"
          },
          "tier": {
            "type": "string",
            "description": "top, mega, mid, mini, people"
          },
          "min_followers": {
            "type": "integer"
          },
          "min_engagement": {
            "type": "number"
          },
          "include_non_tiktok": {
            "type": "boolean",
            "default": false,
            "description": "Include non-TikTok accounts (Instagram-only, YouTube-only, etc)"
          }
        }
      }
    },
    {
      "name": "get_stats",
      "description": "Get database overview statistics for Greece",
      "inputSchema": {
        "type": "object",
        "properties": {}
      }
    },
    {
      "name": "get_categories",
      "description": "Get all creator categories with counts and average metrics for Greece",
      "inputSchema": {
        "type": "object",
        "properties": {}
      }
    },
    {
      "name": "niche_insights",
      "description": "Deep analytics for a specific niche in Greece",
      "inputSchema": {
        "type": "object",
        "properties": {
          "niche": {
            "type": "string",
            "minLength": 1,
            "description": "Niche to analyze"
          }
        },
        "required": [
          "niche"
        ]
      }
    },
    {
      "name": "suggest_creators_for_brief",
      "description": "Campaign creator suggestions for Greece",
      "inputSchema": {
        "type": "object",
        "properties": {
          "niche": {
            "type": "string"
          },
          "objective": {
            "type": "string",
            "enum": [
              "awareness",
              "engagement",
              "conversions",
              "content"
            ],
            "default": "engagement"
          },
          "budget": {
            "type": "string",
            "enum": [
              "low",
              "medium",
              "high"
            ],
            "default": "medium"
          },
          "limit": {
            "type": "integer",
            "minimum": 1,
            "maximum": 20,
            "default": 10
          },
          "min_engagement": {
            "type": "number"
          }
        },
        "required": [
          "niche"
        ]
      }
    },
    {
      "name": "get_creator_intelligence",
      "description": "Get cached intelligence analysis — content, comment sentiment, and video analysis",
      "inputSchema": {
        "type": "object",
        "properties": {
          "username": {
            "type": "string",
            "minLength": 1
          },
          "type": {
            "type": "string",
            "enum": [
              "content",
              "comments",
              "video",
              "all"
            ],
            "default": "all"
          }
        },
        "required": [
          "username"
        ]
      }
    },
    {
      "name": "get_live_now",
      "description": "Get currently live Greek creators on TikTok — who is streaming right now with viewer counts, duration, titles",
      "inputSchema": {
        "type": "object",
        "properties": {}
      }
    },
    {
      "name": "get_x_trends",
      "description": "Get X (formerly Twitter) trends in Greece — real-time trending topics, hashtags, keywords. Hourly tracking with analytics labels and rank history.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "period": {
            "type": "string",
            "enum": [
              "now",
              "24h",
              "7d",
              "30d",
              "month"
            ],
            "default": "now",
            "description": "\"now\" current top 50, \"24h\" last 24h, \"7d\" last 7 days, \"30d\" last 30 days, \"month\" current month"
          }
        }
      }
    },
    {
      "name": "get_x_trend_intelligence",
      "description": "Deep intelligence on X/Twitter trending topics in Greece — persistence scores, peak rank, total appearances, streaks, trend lifecycle. Leaderboard or single-topic drill-down.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "trend": {
            "type": "string",
            "description": "Optional specific trend/hashtag. Omit for full leaderboard."
          },
          "limit": {
            "type": "number",
            "description": "Max trends in leaderboard (1-100). Default 30."
          }
        }
      }
    },
    {
      "name": "get_x_top_tweets",
      "description": "Top tweets from DASHR-tracked Greek X accounts — most liked/viewed/retweeted/recent. Filter by tweet type and look-back window.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "enum": [
              "all",
              "original",
              "reply",
              "quote",
              "retweet"
            ],
            "default": "all"
          },
          "sort": {
            "type": "string",
            "enum": [
              "likes",
              "views",
              "retweets",
              "replies",
              "recent"
            ],
            "default": "likes"
          },
          "days": {
            "type": "number",
            "description": "Look-back window days (1-365). Default 7."
          },
          "limit": {
            "type": "number",
            "description": "Max tweets (1-100). Default 20."
          }
        }
      }
    },
    {
      "name": "get_collaborations",
      "description": "Creator↔brand collaborations & tagged mentions. Collaboration = mentioned account resolves to a brand; flags paid partnerships. Pass a TikTok/IG/X username.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "username": {
            "type": "string",
            "description": "Creator handle (TikTok/IG/X username)."
          }
        },
        "required": [
          "username"
        ]
      }
    },
    {
      "name": "get_brand_creators",
      "description": "Reverse lookup: creators who tagged a brand. Each row is one tagged post with creator + paid flag + date. Pass a brand handle or display name.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "brand": {
            "type": "string",
            "description": "Brand handle or display name (e.g. \"geely_greece\", \"Geely\")."
          }
        },
        "required": [
          "brand"
        ]
      }
    },
    {
      "name": "get_x_trend_tweets",
      "description": "Representative tweets for a specific X/Twitter trending topic in Greece. Omit trend= to use current #1 GR trend.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "trend": {
            "type": "string",
            "description": "Trend or hashtag. Omit for current #1 GR trend."
          },
          "type": {
            "type": "string",
            "enum": [
              "Top",
              "Latest"
            ],
            "default": "Top"
          },
          "limit": {
            "type": "number",
            "description": "Max tweets (1-50). Default 20."
          }
        }
      }
    },
    {
      "name": "get_tv_ratings",
      "description": "Get Greek TV ratings — daily viewership data (dynamic % and total %) per channel/show/time slot. Use when asked about τηλεθεάσεις, channel rankings, or show popularity.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "date": {
            "type": "string",
            "description": "YYYY-MM-DD or \"latest\""
          },
          "channel": {
            "type": "string",
            "description": "Channel name filter"
          },
          "show": {
            "type": "string",
            "description": "Show name filter"
          },
          "time_slot": {
            "type": "string",
            "description": "Time slot filter (Prime Time, Daytime, etc.)"
          },
          "limit": {
            "type": "integer",
            "minimum": 1,
            "maximum": 200,
            "default": 50
          }
        }
      }
    },
    {
      "name": "get_media_campaigns",
      "description": "Get Greek media advertising campaigns (TV & digital). Modes: \"stats\" (overview), \"campaigns\" (filtered list), \"top_advertisers\", \"agency_share\".",
      "inputSchema": {
        "type": "object",
        "properties": {
          "advertiser": {
            "type": "string",
            "description": "Advertiser name (partial match)"
          },
          "agency": {
            "type": "string",
            "description": "Media agency name"
          },
          "website": {
            "type": "string",
            "description": "Website domain to find campaigns on"
          },
          "username": {
            "type": "string",
            "description": "DASHR brand username to find campaigns for"
          },
          "type": {
            "type": "string",
            "enum": [
              "digital",
              "tv",
              "all"
            ],
            "default": "all"
          },
          "mode": {
            "type": "string",
            "enum": [
              "campaigns",
              "stats",
              "top_advertisers",
              "agency_share"
            ],
            "default": "campaigns"
          },
          "limit": {
            "type": "integer",
            "minimum": 1,
            "maximum": 100,
            "default": 20
          }
        }
      }
    },
    {
      "name": "get_creator_history",
      "description": "Get historical data points for a Greek creator",
      "inputSchema": {
        "type": "object",
        "properties": {
          "username": {
            "type": "string",
            "minLength": 1
          }
        },
        "required": [
          "username"
        ]
      }
    },
    {
      "name": "get_trending_videos",
      "description": "Trending TikTok videos in Greece",
      "inputSchema": {
        "type": "object",
        "properties": {
          "limit": {
            "type": "integer",
            "minimum": 1,
            "maximum": 50,
            "default": 20
          }
        }
      }
    },
    {
      "name": "get_trending_sounds",
      "description": "Trending TikTok sounds in Greece",
      "inputSchema": {
        "type": "object",
        "properties": {
          "limit": {
            "type": "integer",
            "minimum": 1,
            "maximum": 50,
            "default": 20
          }
        }
      }
    },
    {
      "name": "get_trending_hashtags",
      "description": "Trending TikTok hashtags in Greece",
      "inputSchema": {
        "type": "object",
        "properties": {
          "limit": {
            "type": "integer",
            "minimum": 1,
            "maximum": 50,
            "default": 20
          }
        }
      }
    },
    {
      "name": "get_similar_creators",
      "description": "Find similar creators in Greece",
      "inputSchema": {
        "type": "object",
        "properties": {
          "username": {
            "type": "string",
            "minLength": 1
          },
          "limit": {
            "type": "integer",
            "minimum": 1,
            "maximum": 20,
            "default": 10
          }
        },
        "required": [
          "username"
        ]
      }
    },
    {
      "name": "get_category_creators",
      "description": "Creators in a category for Greece",
      "inputSchema": {
        "type": "object",
        "properties": {
          "category": {
            "type": "string",
            "minLength": 1
          },
          "sort": {
            "type": "string",
            "enum": [
              "followers",
              "engagement",
              "avg_views"
            ],
            "default": "engagement"
          },
          "limit": {
            "type": "integer",
            "minimum": 1,
            "maximum": 50,
            "default": 20
          }
        },
        "required": [
          "category"
        ]
      }
    },
    {
      "name": "compare_creators",
      "description": "Compare 2-3 Greek creators side by side (multi-platform: TikTok + IG + FB)",
      "inputSchema": {
        "type": "object",
        "properties": {
          "usernames": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "minItems": 2,
            "maxItems": 3
          }
        },
        "required": [
          "usernames"
        ]
      }
    },
    {
      "name": "tier_breakdown",
      "description": "Tier breakdown for Greece",
      "inputSchema": {
        "type": "object",
        "properties": {
          "category": {
            "type": "string"
          }
        }
      }
    },
    {
      "name": "get_pagespeed",
      "description": "Get PageSpeed Insights scores for a website — performance, SEO, accessibility, best practices, Core Web Vitals",
      "inputSchema": {
        "type": "object",
        "properties": {
          "domain": {
            "type": "string",
            "minLength": 1,
            "description": "Domain to check (e.g. dashr.live)"
          },
          "scan": {
            "type": "boolean",
            "default": false,
            "description": "If true, triggers a fresh scan"
          }
        },
        "required": [
          "domain"
        ]
      }
    },
    {
      "name": "get_website_traffic",
      "description": "Get website traffic data (SimilarWeb)",
      "inputSchema": {
        "type": "object",
        "properties": {
          "domain": {
            "type": "string",
            "minLength": 1
          },
          "period": {
            "type": "string"
          }
        },
        "required": [
          "domain"
        ]
      }
    },
    {
      "name": "list_top_websites",
      "description": "List top Greek websites by traffic (SimilarWeb)",
      "inputSchema": {
        "type": "object",
        "properties": {
          "category": {
            "type": "string"
          },
          "period": {
            "type": "string"
          },
          "sort": {
            "type": "string",
            "enum": [
              "visits",
              "traffic_share",
              "bounce_rate",
              "pages_per_visit",
              "unique_visitors"
            ],
            "default": "visits"
          },
          "limit": {
            "type": "integer",
            "minimum": 1,
            "maximum": 100,
            "default": 20
          }
        }
      }
    },
    {
      "name": "compare_websites",
      "description": "Compare 2-3 websites (SimilarWeb)",
      "inputSchema": {
        "type": "object",
        "properties": {
          "domains": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "minItems": 2,
            "maxItems": 3
          }
        },
        "required": [
          "domains"
        ]
      }
    },
    {
      "name": "get_dashr_hashtags",
      "description": "DASHR-computed hashtag analytics from Greek creator posts",
      "inputSchema": {
        "type": "object",
        "properties": {
          "account_type": {
            "type": "string",
            "enum": [
              "all",
              "media",
              "politician",
              "brand",
              "podcast",
              "influencer"
            ],
            "default": "all"
          },
          "sort": {
            "type": "string",
            "enum": [
              "total_views",
              "total_posts",
              "total_creators",
              "growth_pct",
              "views_48h",
              "views_30d",
              "virality_score"
            ],
            "default": "total_views"
          },
          "limit": {
            "type": "integer",
            "minimum": 1,
            "maximum": 100,
            "default": 30
          },
          "search": {
            "type": "string"
          }
        }
      }
    },
    {
      "name": "get_public_contracts",
      "description": "Get KIMDIS public procurement contracts for a Greek brand by username",
      "inputSchema": {
        "type": "object",
        "properties": {
          "username": {
            "type": "string",
            "minLength": 1,
            "description": "Brand username (without @)"
          },
          "limit": {
            "type": "integer",
            "minimum": 1,
            "maximum": 100,
            "default": 10
          }
        },
        "required": [
          "username"
        ]
      }
    },
    {
      "name": "get_youtube_trending",
      "description": "Get YouTube trending videos in Greece by category (Music, Sports, Entertainment, Film, Gaming, General)",
      "inputSchema": {
        "type": "object",
        "properties": {
          "category": {
            "type": "string",
            "enum": [
              "General",
              "Music",
              "Sports",
              "Entertainment",
              "Film",
              "Gaming"
            ],
            "description": "Filter by category. Omit for all."
          },
          "date": {
            "type": "string",
            "description": "Date in YYYY-MM-DD format. Defaults to today."
          }
        }
      }
    },
    {
      "name": "get_places",
      "description": "Get Google Places data for a brand — locations, ratings, reviews, opening hours, business status. Reads stored data only.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "username": {
            "type": "string",
            "minLength": 1,
            "description": "Brand username (without @)"
          }
        },
        "required": [
          "username"
        ]
      }
    }
  ],
  "resources": [
    {
      "name": "platform-info",
      "uri": "dashr://platform-info",
      "mimeType": "text/plain",
      "description": "DASHR platform documentation"
    },
    {
      "name": "database-overview",
      "uri": "dashr://database-overview",
      "mimeType": "application/json",
      "description": "Live database stats (5-min cache)"
    }
  ],
  "connect": {
    "claude_desktop": {
      "mcpServers": {
        "dashr": {
          "type": "url",
          "url": "https://dashr.live/mcp"
        }
      }
    },
    "cursor": {
      "mcpServers": {
        "dashr": {
          "url": "https://dashr.live/mcp"
        }
      }
    }
  },
  "rest_api": {
    "description": "Plain JSON REST API — no MCP protocol needed. Works with ChatGPT, Perplexity, any HTTP client.",
    "base_url": "https://dashr.live/mcp/api",
    "endpoints": [
      {
        "method": "GET",
        "path": "/api/search?q=keyword&limit=20",
        "description": "Search creators by keyword"
      },
      {
        "method": "GET",
        "path": "/api/creators?category=Food&sort=engagement&limit=10",
        "description": "List/filter creators"
      },
      {
        "method": "GET",
        "path": "/api/creator/{username}",
        "description": "Get single creator profile"
      },
      {
        "method": "GET",
        "path": "/api/stats",
        "description": "Database statistics"
      },
      {
        "method": "GET",
        "path": "/api/categories",
        "description": "All categories with metrics"
      },
      {
        "method": "GET",
        "path": "/api/trending/videos?limit=20",
        "description": "Trending TikTok videos in Greece"
      },
      {
        "method": "GET",
        "path": "/api/trending/sounds?limit=20",
        "description": "Trending TikTok sounds in Greece"
      },
      {
        "method": "GET",
        "path": "/api/trending/hashtags?limit=20",
        "description": "Trending TikTok hashtags in Greece"
      },
      {
        "method": "GET",
        "path": "/api/live",
        "description": "Currently live Greek TikTok creators"
      },
      {
        "method": "GET",
        "path": "/api/x-trends?period=now",
        "description": "Twitter/X trending topics in Greece (now or 24h)"
      },
      {
        "method": "GET",
        "path": "/api/media-campaigns?mode=stats",
        "description": "Greek media advertising campaigns — TV & digital monitoring"
      }
    ]
  },
  "website": "https://dashr.live"
}