Skip to main content
Connect your agent to Bright’s MCP server to search knowledge bases and run query models within your authenticated organization context.

​
Connect your agent

Configure your MCP-compatible agent to use the Bright MCP server. Ensure the agent is authenticated for your organization (e.g., bearer token/API key depending on your environment). Once connected, the following tools are available.

​
Core tools

  • search: Semantic search across a knowledge base (kb optional, defaults to “general”)
  • list_query_models: Discover available query models
  • get_query_model: Retrieve a specific query model by ID or name
  • run_query_model: Execute a query model with parameters
  • get_knowledge_bases / get_knowledge_base_by_id_or_name: Explore KBs
  • get_engines / get_engine_by_id_or_name and get_databases / get_database_by_id_or_name: Inspect execution environments
  • list_entities / get_entity_by_id: Fetch entities by ID (read-only)

​
Examples

{
  "tool": "search",
  "params": {
    "query": "OAuth 2.0",
    "kb": "product-docs",
    "limit": 5,
    "objectType": "Entity",
    "types": ["Guide"]
  }
}

{
  "tool": "list_query_models",
  "params": { "limit": 20, "enabled": true }
}

{
  "tool": "get_query_model",
  "params": { "idOrName": "find_investors_by_stage" }
}

{
  "tool": "run_query_model",
  "params": {
    "idOrName": "find_investors_by_stage",
    "parameters": { "stage": "series-a" }
  }
}

{
  "tool": "get_knowledge_bases",
  "params": {}
}

​
Tips

Use filters (objectType, types, properties) to refine search results and reduce noise.