MCP Server

Each BeforeQuery project ships a built-in MCP server (JSON-RPC 2.0 over Streamable HTTP). Any MCP-compatible client — AI-powered IDEs, desktop assistants, agent frameworks — can search and query your knowledge base as native tools.

Endpoint

POST https://api.agents.beforequery.com/mcp/projects/:projectId

Authentication (client key): X-Client-Key header, Authorization: Bearer bq_pk_..., or ?client_key= query parameter.

Supported methods

initialize, tools/list, tools/call, ping.

Tools

Tool	Input	Returns
`search_docs`	`{ "query": string, "limit"?: number }`	Top matching chunks with titles, URLs, and scores
`ask_question`	`{ "question": string }`	A RAG-generated answer with citations
`list_sources`	`{}`	The project’s indexed sources

Restricted documents are excluded from MCP retrieval, like all client-key surfaces.

Configure an MCP client

Most MCP clients accept a remote server config like:

{
  "mcpServers": {
    "acme-docs": {
      "url": "https://api.agents.beforequery.com/mcp/projects/proj_xxx",
      "headers": { "X-Client-Key": "bq_pk_..." }
    }
  }
}

Call it from the agents SDK

@beforequery/agents wraps the MCP tools with typed methods (the initialize handshake happens lazily):

import { BeforeQueryAgents } from "@beforequery/agents";

const client = new BeforeQueryAgents({ clientKey: "bq_pk_..." });

const results = await client.searchDocs("proj_xxx", "pgvector cosine similarity", { limit: 5 });
const answer = await client.askQuestion("proj_xxx", "What is the recommended chunk size?");
const sources = await client.listSources("proj_xxx");

Raw JSON-RPC example

curl -X POST https://api.agents.beforequery.com/mcp/projects/proj_xxx \
  -H "X-Client-Key: bq_pk_..." \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "search_docs",
      "arguments": { "query": "rate limiting", "limit": 5 }
    }
  }'

MCP calls are recorded as mcp traces in observability.

Get Started

Knowledge Sources

Knowledge Connectors

Community Sources

Helpdesk Tickets

Deploy

Platform

Account Management

Endpoint

Supported methods

Tools

Configure an MCP client

Call it from the agents SDK

Raw JSON-RPC example

​Endpoint

​Supported methods

​Tools

​Configure an MCP client

​Call it from the agents SDK

​Raw JSON-RPC example

Endpoint

Supported methods

Tools

Configure an MCP client

Call it from the agents SDK

Raw JSON-RPC example