mcp · primate-intelligence — Claude Code MCP server for video analysis and setup
This server connects agents to the Primate Vision API to ask questions about video scenes. Use it to check whether a specific event appears in a clip.
claude mcp add --transport http mcp https://api.primateintelligence.ai/mcpWhat mcp does
The server gives an agent tools to register a video from a public HTTPS URL and analyse it with a plain-language question. Results include a yes, no or indeterminate answer, a confidence score and clip timestamps. Before spending credits, the agent can check whether a question can be assessed and preview its estimated cost.
Connect to the hosted server with OAuth, or run the local version through npx. Local use requires PRIMATE_API_KEY as an environment variable; tools do not accept credentials as arguments. Videos must be reachable through public HTTPS URLs, so a private clip without such a URL cannot be submitted.
What it helps with
- check whether a person appears in a video
- locate timestamps for a specific scene
- check if a question can be assessed before analysis
- run several checks against one video
Example prompts for the agent
- Check whether this video contains a person and return the relevant timestamps.
- Tell me whether this clip shows a car, and preview the estimated cost first.
- Check this video for a person and a car.
How to install mcp
1Platform CLI: remote server
claude mcp add --transport http mcp https://api.primateintelligence.ai/mcp2Platform CLI
claude mcp add --env PRIMATE_API_KEY=<PRIMATE_API_KEY> --transport stdio primate-intelligence-mcp -- npx -y @primate-intelligence/mcpReplace <…> with your own values
1Platform CLI: remote server
codex mcp add primate-intelligence-mcp --url https://api.primateintelligence.ai/mcp2Platform CLI
codex mcp add primate-intelligence-mcp --env PRIMATE_API_KEY=<PRIMATE_API_KEY> -- npx -y @primate-intelligence/mcpReplace <…> with your own values
Config file
{
"mcpServers": {
"primate-intelligence-mcp": {
"url": "https://api.primateintelligence.ai/mcp"
}
}
}{
"mcpServers": {
"primate-intelligence-mcp": {
"command": "npx",
"args": [
"-y",
"@primate-intelligence/mcp"
],
"env": {
"PRIMATE_API_KEY": "<PRIMATE_API_KEY>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"primate-intelligence-mcp": {
"type": "http",
"url": "https://api.primateintelligence.ai/mcp"
}
}
}{
"servers": {
"primate-intelligence-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@primate-intelligence/mcp"
],
"env": {
"PRIMATE_API_KEY": "<PRIMATE_API_KEY>"
}
}
}
}Replace <…> with your own values
1Platform CLI: remote server
gemini mcp add -t http primate-intelligence-mcp https://api.primateintelligence.ai/mcp2Platform CLI
gemini mcp add -e PRIMATE_API_KEY=<PRIMATE_API_KEY> primate-intelligence-mcp npx -y @primate-intelligence/mcpReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about mcp
How do I install mcp in Claude Code?
For the hosted connection, run claude mcp add --transport http mcp https://api.primateintelligence.ai/mcp. Sign-in uses OAuth.
What does mcp do?
It connects an agent to the Primate Vision API so it can ask questions about video scenes. Results provide an answer, confidence and clip timestamps.
Do I need an API key?
Local mode requires PRIMATE_API_KEY in the environment. The hosted server uses OAuth.
Similar MCP servers
MCP servers catalog →mcp by other authors comes first.
