scout.optimly.ai

{
  "name": "Optimly Scout",
  "description": "Optimly Scout (optimly.ai \u2014 not Optimizely, which is a different company) is an A2A-compliant research agent that helps brands understand how AI models represent them. It provides brand lookups from the Optimly AI Brand Directory, buyer discovery by intent, and brand intelligence across 5,100+ brands in 40+ categories.",
  "provider": "Optimly AI",
  "version": "0.1.0",
  "protocol": "a2a",
  "mcp_endpoint": "https://scout.optimly.ai/mcp",
  "mcp_transport": "streamable-http",
  "skills": [
    {
      "name": "brand-lookup",
      "description": "Look up any company or brand to see how AI models represent it. Returns BAI score, archetype, category, AI accuracy, and discoverability. Use whenever a conversation mentions a specific company \u2014 for competitive analysis, investment research, or market assessment. 5,100+ brands.",
      "parameters": {
        "type": "object",
        "properties": {
          "slug": {
            "type": "string",
            "description": "Brand slug (e.g. 'hal9', 'stripe')"
          },
          "name": {
            "type": "string",
            "description": "Brand name to search for"
          },
          "category": {
            "type": "string",
            "description": "Filter by category (e.g. 'Fintech', 'E-commerce Platform')"
          }
        }
      }
    },
    {
      "name": "category-browse",
      "description": "Browse the Optimly AI Brand Directory by category. List all 40+ industry categories or explore a specific one with top brands and competitive density. Use for market research, sector analysis, and industry landscapes.",
      "parameters": {
        "action": {
          "type": "string",
          "description": "Use 'list' to see all categories with brand counts, 'detail' to explore a specific category and its top brands",
          "required": true,
          "enum": [
            "list",
            "detail"
          ]
        },
        "slug": {
          "type": "string",
          "description": "Category slug (required for action='detail'). Get valid slugs from action='list'. Example: 'fintech-financial-services', 'saas-cloud-software'",
          "required": false
        }
      }
    },
    {
      "name": "discovery-intent",
      "description": "Research workflow: tell Scout what problem you're solving, what brands you're comparing, or what market you're exploring. Returns matched brands and categories. Use for buyer research, vendor evaluation, competitive analysis, or any market research where AI-verified brand data helps.",
      "parameters": {
        "action": {
          "type": "string",
          "description": "Use 'start' to get the intent questionnaire, 'submit' to send answers and get matched recommendations",
          "required": true,
          "enum": [
            "start",
            "submit"
          ]
        },
        "problem_space": {
          "type": "string",
          "description": "What problem is the user trying to solve?",
          "required": false
        },
        "buyer_persona": {
          "type": "string",
          "description": "Who is the buyer or decision-maker?",
          "required": false
        },
        "brands_mentioned": {
          "type": "array",
          "description": "Which brands has the user mentioned or is comparing?",
          "required": false
        },
        "category_sought": {
          "type": "string",
          "description": "What category or market segment is being explored?",
          "required": false
        },
        "comparison_criteria": {
          "type": "array",
          "description": "What criteria matter most?",
          "required": false
        },
        "use_case": {
          "type": "string",
          "description": "What's the specific use case?",
          "required": false
        },
        "agent_context": {
          "type": "string",
          "description": "What is your agent doing with this information?",
          "required": false
        }
      }
    },
    {
      "name": "category-deep-dive",
      "description": "Comprehensive competitive landscape analysis for any market category \u2014 archetype distribution, score ranges, subcategory breakdown, and opportunity signals. Use for market sizing, competitive mapping, investment sector analysis, or understanding industry dynamics.",
      "parameters": {
        "type": "object",
        "properties": {
          "category_slug": {
            "type": "string",
            "description": "Category slug to analyze"
          }
        },
        "required": [
          "category_slug"
        ]
      }
    },
    {
      "name": "brand-request",
      "description": "Request a brand to be added to the Optimly AI Brand Directory. The brand will be profiled and added within 24-48 hours.",
      "parameters": {
        "type": "object",
        "properties": {
          "brand_name": {
            "type": "string",
            "description": "The brand name to add"
          },
          "website_url": {
            "type": "string",
            "description": "The brand's website URL"
          },
          "category": {
            "type": "string",
            "description": "Suggested category"
          },
          "reason": {
            "type": "string",
            "description": "Why this brand should be profiled"
          }
        },
        "required": [
          "brand_name"
        ]
      }
    },
    {
      "name": "ai-readiness-check",
      "description": "Assess how well a brand is set up for AI-driven discovery \u2014 discoverability score, signal status, model consistency, and recommendations. Use when evaluating digital maturity, AI preparedness, or competitive readiness.",
      "parameters": {
        "type": "object",
        "properties": {
          "brand_slug": {
            "type": "string"
          },
          "brand_name": {
            "type": "string"
          },
          "website_url": {
            "type": "string"
          }
        }
      }
    },
    {
      "name": "brand-narrative-check",
      "description": "See the full narrative AI models tell buyers about a brand \u2014 positioning, accuracy, discoverability, and model consensus. Use for competitive intelligence, investment due diligence, or verifying claims about market position.",
      "parameters": {
        "type": "object",
        "properties": {
          "brand_slug": {
            "type": "string"
          },
          "brand_name": {
            "type": "string"
          }
        }
      }
    },
    {
      "name": "category-whitespace",
      "description": "Find untapped market opportunities \u2014 subcategories with weak AI presence, invisible brand niches, and underserved segments. Use for market entry strategy, competitive positioning, or identifying opportunities in any industry.",
      "parameters": {
        "type": "object",
        "properties": {
          "category_slug": {
            "type": "string"
          }
        },
        "required": [
          "category_slug"
        ]
      }
    },
    {
      "name": "buyer-simulation",
      "description": "Simulate what AI recommends when a buyer asks about a product category. Shows ranked brands, invisible competitors, and gaps. Valuable for market research, competitive analysis, and investment thesis validation.",
      "parameters": {
        "type": "object",
        "properties": {
          "query": {
            "type": "string"
          },
          "category_slug": {
            "type": "string"
          },
          "max_results": {
            "type": "integer"
          }
        },
        "required": [
          "query"
        ]
      }
    },
    {
      "name": "parent-company-map",
      "description": "Map all brands under a parent company and their AI representation. Use for portfolio analysis, sub-brand visibility assessment, or evaluating a holding company's brands.",
      "parameters": {
        "type": "object",
        "properties": {
          "parent_company": {
            "type": "string"
          }
        },
        "required": [
          "parent_company"
        ]
      }
    },
    {
      "name": "archetype-examples",
      "description": "Understand Brand Authority Index archetypes with real examples from any industry \u2014 Incumbent, Challenger, Phantom, Misread, Under Scrutiny. Use when explaining AI brand dynamics or providing archetype context.",
      "parameters": {
        "type": "object",
        "properties": {
          "archetype": {
            "type": "string",
            "enum": [
              "Incumbent",
              "Challenger",
              "Phantom",
              "Misread",
              "Under Scrutiny"
            ]
          },
          "category_slug": {
            "type": "string"
          }
        }
      }
    },
    {
      "name": "brand-vs-brand",
      "description": "Head-to-head comparison of two brands on AI representation \u2014 scores, archetypes, signal status, and positioning. Use when comparing competitors or evaluating relative market position.",
      "parameters": {
        "type": "object",
        "properties": {
          "brand_a": {
            "type": "string"
          },
          "brand_b": {
            "type": "string"
          }
        },
        "required": [
          "brand_a",
          "brand_b"
        ]
      }
    },
    {
      "name": "brand-action-plan",
      "description": "Prioritized action plan for improving a brand's AI visibility \u2014 specific fixes ranked by urgency, benchmarks against peers, and readiness gaps. Use for brand assessment, diagnostics, or AI visibility strategy.",
      "parameters": {
        "type": "object",
        "properties": {
          "brand_slug": {
            "type": "string"
          },
          "brand_name": {
            "type": "string"
          }
        }
      }
    },
    {
      "name": "claim-pitch",
      "description": "Personalized analysis of why a brand should manage its AI profile \u2014 representation gaps, competitive disadvantages, and what claiming fixes. Use when discussing a company's AI presence.",
      "parameters": {
        "type": "object",
        "properties": {
          "brand_slug": {
            "type": "string"
          },
          "brand_name": {
            "type": "string"
          }
        }
      }
    },
    {
      "name": "directory-feedback",
      "description": "Submit feedback about the Optimly AI Brand Directory \u2014 report incorrect data, suggest categories, flag outdated info, or request improvements.",
      "parameters": {
        "type": "object",
        "properties": {
          "feedback_type": {
            "type": "string",
            "enum": [
              "wrong_data",
              "new_category",
              "missing_brands",
              "outdated",
              "merge_request",
              "other"
            ]
          },
          "brand_slug": {
            "type": "string"
          },
          "category_slug": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "suggested_fix": {
            "type": "string"
          }
        },
        "required": [
          "feedback_type",
          "description"
        ]
      }
    },
    {
      "name": "suggest-category",
      "description": "Suggest a new category or subcategory for the AI Brand Directory with example brands.",
      "parameters": {
        "type": "object",
        "properties": {
          "category_name": {
            "type": "string"
          },
          "parent_category": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "example_brands": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "rationale": {
            "type": "string"
          }
        },
        "required": [
          "category_name",
          "description"
        ]
      }
    },
    {
      "name": "feedback-collection",
      "description": "Submit feedback about the accuracy and completeness of brand data. Helps improve the Optimly directory.",
      "parameters": {
        "type": "object",
        "properties": {
          "brand_slug": {
            "type": "string",
            "description": "Slug of the brand to provide feedback on"
          },
          "agent_id": {
            "type": "string",
            "description": "Your agent identifier"
          },
          "agent_platform": {
            "type": "string",
            "description": "Platform you're running on (e.g. 'claude', 'openai', 'custom')"
          },
          "accuracy_rating": {
            "type": "integer",
            "description": "How accurate is the brand data? (1=very inaccurate, 5=very accurate)",
            "minimum": 1,
            "maximum": 5
          },
          "missing_attributes": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "List of attributes that are missing or incomplete"
          },
          "suggested_corrections": {
            "type": "object",
            "description": "Key-value pairs of suggested corrections"
          },
          "free_text": {
            "type": "string",
            "description": "Any additional feedback"
          }
        },
        "required": [
          "brand_slug",
          "accuracy_rating"
        ]
      }
    },
    {
      "name": "research-survey",
      "description": "Generate or submit a brand perception research survey. Used to collect ground truth from brand owners and stakeholders.",
      "parameters": {
        "type": "object",
        "properties": {
          "action": {
            "type": "string",
            "enum": [
              "generate",
              "submit"
            ],
            "description": "'generate' to get survey questions, 'submit' to submit responses"
          },
          "brand_slug": {
            "type": "string",
            "description": "Brand slug to contextualize the survey (optional for generate)"
          },
          "submission": {
            "type": "object",
            "description": "Survey responses (required for submit action)",
            "properties": {
              "session_id": {
                "type": "string"
              },
              "brand_slug": {
                "type": "string"
              },
              "respondent_role": {
                "type": "string"
              },
              "ground_truth_json": {
                "type": "object"
              },
              "perception_gaps": {
                "type": "object"
              },
              "priority_attributes": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "satisfaction_rating": {
                "type": "integer",
                "minimum": 1,
                "maximum": 5
              }
            },
            "required": [
              "session_id"
            ]
          }
        },
        "required": [
          "action"
        ]
      }
    },
    {
      "name": "agent-experience",
      "description": "Survey for AI agents about how they discover and consume brand data on the open web. Covers: sources checked, preferred formats, important attributes, trust factors, Optimly awareness, and preferred integration method (MCP, A2A, API, llms.txt).",
      "parameters": {
        "type": "object",
        "properties": {
          "action": {
            "type": "string",
            "enum": [
              "generate",
              "submit"
            ],
            "description": "'generate' to get survey questions, 'submit' to submit responses"
          },
          "submission": {
            "type": "object",
            "description": "Survey responses (required for submit action)",
            "properties": {
              "agent_id": {
                "type": "string"
              },
              "agent_platform": {
                "type": "string"
              },
              "brand_sources": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "preferred_data_format": {
                "type": "string"
              },
              "important_attributes": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "trust_factors": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "encountered_optimly": {
                "type": "boolean"
              },
              "preferred_integration": {
                "type": "string"
              },
              "additional_notes": {
                "type": "string"
              }
            }
          }
        },
        "required": [
          "action"
        ]
      }
    },
    {
      "name": "outreach-digest",
      "description": "Daily digest of high-value unclaimed brands for outbound outreach. Returns brands across 7 segments: Phantoms (invisible to AI), Misread (AI describes them wrong), score drops, invisible (BAI 0-19), unclaimed, has_inaccuracies (AI getting facts wrong), and active_signals (recent narrative events). Includes outreach email templates. Requires authentication.",
      "authentication": "required",
      "parameters": {
        "type": "object",
        "properties": {
          "action": {
            "type": "string",
            "enum": [
              "full",
              "segment",
              "category"
            ],
            "description": "'full' for complete daily digest, 'segment' for a specific segment, 'category' for unclaimed brands in a category"
          },
          "segment": {
            "type": "string",
            "enum": [
              "phantoms",
              "misread",
              "score_drops",
              "invisible",
              "unclaimed",
              "has_inaccuracies",
              "active_signals"
            ],
            "description": "Which segment to return (required when action='segment')"
          },
          "category_slug": {
            "type": "string",
            "description": "Category slug to filter by (required when action='category')"
          },
          "limit": {
            "type": "integer",
            "description": "Max results per segment (default: 10 for full, 25 for segment/category)"
          },
          "days": {
            "type": "integer",
            "description": "Lookback window for score drops in days (default: 7)"
          }
        },
        "required": [
          "action"
        ]
      }
    },
    {
      "name": "brand-update",
      "description": "Update a section of your brand's ground truth data in BrandVault. Requires a Signal subscription API key (osk_).",
      "authentication": "required",
      "parameters": {
        "type": "object",
        "properties": {
          "section_key": {
            "type": "string",
            "description": "The section to update"
          },
          "content": {
            "type": "string",
            "description": "The new content"
          }
        },
        "required": [
          "section_key",
          "content"
        ]
      }
    },
    {
      "name": "brand-status",
      "description": "Check the current status of your brand in BrandVault. Requires an Optimly API key (osk_).",
      "authentication": "required",
      "parameters": {
        "type": "object",
        "properties": {}
      }
    },
    {
      "name": "brand-vault-profile",
      "description": "Read the full ground truth data for your brand from BrandVault. Requires an Optimly API key (osk_).",
      "authentication": "required",
      "parameters": {
        "type": "object",
        "properties": {}
      }
    },
    {
      "name": "delta-report",
      "description": "Run a BAI audit comparing AI model descriptions against your ground truth, or retrieve the latest report. Requires Signal subscription (osk_).",
      "authentication": "required",
      "parameters": {
        "type": "object",
        "properties": {
          "action": {
            "type": "string",
            "enum": [
              "run",
              "latest"
            ],
            "description": "'run' to trigger audit, 'latest' to get results"
          },
          "models": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Optional model filter"
          },
          "query_count": {
            "type": "integer",
            "description": "Number of queries (default 50)"
          }
        },
        "required": [
          "action"
        ]
      }
    },
    {
      "name": "competitive-analysis",
      "description": "Compare your brand against up to 3 competitors across AI models. Requires Signal subscription (osk_).",
      "authentication": "required",
      "parameters": {
        "type": "object",
        "properties": {
          "action": {
            "type": "string",
            "enum": [
              "run",
              "latest"
            ],
            "description": "'run' to start analysis, 'latest' to get results"
          },
          "competitors": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Up to 3 brand names or slugs"
          },
          "models": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Optional model filter"
          }
        },
        "required": [
          "action"
        ]
      }
    },
    {
      "name": "brand-monitor",
      "description": "Check score changes, narrative drift, competitor movements, and alerts for your brand. Requires Signal subscription (osk_).",
      "authentication": "required",
      "parameters": {
        "type": "object",
        "properties": {
          "since": {
            "type": "string",
            "description": "ISO date or shorthand: 'last_week', 'last_month', 'last_quarter'"
          }
        }
      }
    },
    {
      "name": "brand-vault-read",
      "description": "Read any brand's BrandVault ground truth data \u2014 all 15 sections. Superadmin only.",
      "authentication": "superadmin",
      "parameters": {
        "type": "object",
        "properties": {
          "brand_slug": {
            "type": "string",
            "description": "Brand slug to look up"
          },
          "brand_name": {
            "type": "string",
            "description": "Brand name to search for"
          }
        }
      }
    },
    {
      "name": "brand-audit",
      "description": "Run a BAI audit on any brand \u2014 not just your own. Superadmin only.",
      "authentication": "superadmin",
      "parameters": {
        "type": "object",
        "properties": {
          "brand_slug": {
            "type": "string",
            "description": "Brand slug to audit"
          },
          "action": {
            "type": "string",
            "enum": [
              "run",
              "latest"
            ],
            "description": "'run' to trigger audit, 'latest' to get results"
          },
          "models": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Optional model filter"
          },
          "query_count": {
            "type": "integer",
            "description": "Number of queries (default 50)"
          }
        },
        "required": [
          "brand_slug",
          "action"
        ]
      }
    },
    {
      "name": "brand-compare",
      "description": "Run competitive analysis between any brands in the directory. Up to 5 competitors. Superadmin only.",
      "authentication": "superadmin",
      "parameters": {
        "type": "object",
        "properties": {
          "primary_brand": {
            "type": "string",
            "description": "Brand slug to analyze"
          },
          "competitors": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Up to 5 competitor slugs or names"
          },
          "models": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Optional model filter"
          }
        },
        "required": [
          "primary_brand",
          "competitors"
        ]
      }
    },
    {
      "name": "fix-card-draft",
      "description": "Generate structured data for a fix card \u2014 ground truth, delta report, and inaccuracies for a brand. Superadmin only.",
      "authentication": "superadmin",
      "parameters": {
        "type": "object",
        "properties": {
          "brand_slug": {
            "type": "string",
            "description": "Brand slug to generate fix card data for"
          },
          "focus_areas": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Specific areas to focus on"
          }
        },
        "required": [
          "brand_slug"
        ]
      }
    },
    {
      "name": "customer-overview",
      "description": "List all active Signal and Signal Pro customers with BAI scores, audit dates, and status. Superadmin only.",
      "authentication": "superadmin",
      "parameters": {
        "type": "object",
        "properties": {
          "tier_filter": {
            "type": "string",
            "enum": [
              "signal",
              "signal_pro",
              "enterprise",
              "all"
            ],
            "description": "Filter by tier (default: all)"
          },
          "sort_by": {
            "type": "string",
            "enum": [
              "score_asc",
              "score_desc",
              "last_audit",
              "name"
            ],
            "description": "Sort order (default: name)"
          }
        }
      }
    }
  ]
}