VectorMethods

Docs / MCP

MCP integration

Connect AI assistants and operator tools to VideoVector indexes, prompt runs, search, and workflow resources through MCP.

mcp-server/README.mdmcp-server/src/index.tsapi/mcp_controllers.py

Search documentation

Search pages, API reference sections, and guide headings.

Summary

The VideoVector MCP docs show how AI clients can browse indexes, run prompts, search media evidence, inspect workflow resources, and validate available tools.

Published package and environment names

Use these package and environment identifiers when configuring MCP clients:

  • package: @videosearch/mcp-server
  • command: videosearch-mcp
  • server name: videosearch
  • environment variables: VIDEOSEARCH_*

Transport choices

  • Use stdio for local desktop clients such as Claude Desktop and Cursor.
  • Use http when the MCP server must run as a network-addressable service.

Pages in this section

Public helper endpoints

The API also exposes MCP helper routes:

  • GET /api/v2/mcp/status
  • GET /api/v2/mcp/config
  • GET /api/v2/mcp/tools
  • POST /api/v2/mcp/playground

Use them to inspect capabilities, generate config, and validate tools before deploying the MCP server to users.

Related documentation

This guide connects AI clients to VideoVector tools for media retrieval, prompt execution, workflow inspection, and playground validation.

API reference

The public API accepts either API keys or JWT bearer tokens for most workflow endpoints. API key management endpoints require JWT bearer auth, and `/mcp/config` requires a verified JWT session.

Chat sessions provide an agentic retrieval surface on top of search results and prompt-run scope. The API supports session CRUD, turn creation, optional scope narrowing, and streaming turn events over SSE for agent-search experiences.