> ## Documentation Index
> Fetch the complete documentation index at: https://docs.brightstack.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP

> Connect agents to Bright’s MCP server and use core tools.

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

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

```json theme={null}
{
  "tool": "list_query_models",
  "params": { "limit": 20, "enabled": true }
}
```

```json theme={null}
{
  "tool": "get_query_model",
  "params": { "idOrName": "find_investors_by_stage" }
}
```

```json theme={null}
{
  "tool": "run_query_model",
  "params": {
    "idOrName": "find_investors_by_stage",
    "parameters": { "stage": "series-a" }
  }
}
```

```json theme={null}
{
  "tool": "get_knowledge_bases",
  "params": {}
}
```

### Tips

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