Agent Interviews MCP

1# Agent Interviews MCP
2 
3<p align="center">
4  <a href="https://agentinterviews.com">
5    <img src="https://docs.agentinterviews.com/img/agent-interviews-logo-zip-file/svg/logo-no-background.svg" alt="Agent Interviews Logo" width="400">
6  </a>
7</p>
8 
9[![MCP Compatible](https://img.shields.io/badge/MCP-Compatible-blue.svg)](https://modelcontextprotocol.io)
10 
11> Access your Agent Interviews data directly from Claude and Cursor using Model Context Protocol (MCP)
12 
13## What is Agent Interviews?
14 
15Agent Interviews is a cutting-edge AI interview-as-a-service platform that helps companies streamline their technical assessment process. Our platform allows you to:
16 
17- Create AI interviewers tailored to specific roles and skills
18- Conduct consistent, bias-reduced technical interviews at scale
19- Collect structured data on candidate performance
20- Save engineering time while maintaining high hiring standards
21 
22With Agent Interviews, you can deploy customizable AI interviewers that evaluate candidates through natural conversation, provide detailed reports, and integrate with your existing hiring workflow.
23 
24## Overview
25 
26The Agent Interviews MCP server provides a standardized way for AI assistants to access your interview data, reports, and transcripts using the [Model Context Protocol (MCP)](https://modelcontextprotocol.io). This integration allows Claude, Cursor, and other MCP-compatible AI assistants to seamlessly interact with your Agent Interviews account.
27 
28## Features
29 
30- ✅ **Secure API Access**: Connect to your Agent Interviews account using your API key
31- ✅ **Prefixed Tools**: All tools use the `agentinterviews_` prefix to avoid collisions with other MCPs
32- ✅ **Comprehensive Functionality**: Access interviews, transcripts, reports, projects, and more
33- ✅ **Intuitive Queries**: Ask natural language questions and let the AI determine the right tools to use
34 
35## Documentation
36 
37For comprehensive setup guides and usage instructions, visit our official documentation:
38 
39- [Model Context Protocol Overview](https://docs.agentinterviews.com/MCP/overview/)
40- [Setting Up MCP in Cursor](https://docs.agentinterviews.com/MCP/setup-cursor/)
41- [Setting Up MCP in Claude Desktop](https://docs.agentinterviews.com/MCP/setup-claude/)
42 
43## Quick Start
44 
45### Prerequisites
46 
47- An Agent Interviews account with API access
48- Your Agent Interviews API key
49- MCP-compatible client (Claude Desktop, Cursor, etc.)
50 
51### Cursor Setup
52 
53```json
54{
55  "mcpServers": {
56    "AgentInterviews": {
57      "command": "npx",
58      "args": [
59        "-y",
60        "mcp-remote@latest",
61        "https://api.agentinterviews.com/mcp",
62        "--header",
63        "Authorization:${API_KEY}"
64      ],
65      "env": {
66        "API_KEY": "Api-Key YOUR_API_KEY_HERE"
67      }
68    }
69  }
70}
71```
72 
73### Claude Desktop Setup
74 
75Edit your Claude Desktop config file (accessible via Claude menu → Settings → Developer → Edit Config):
76 
77```json
78{
79  "mcpServers": {
80    "agentinterviews": {
81      "command": "npx",
82      "args": [
83        "-y",
84        "mcp-remote@latest",
85        "https://api.agentinterviews.com/mcp",
86        "--header",
87        "Authorization:${API_KEY}"
88      ],
89      "env": {
90        "API_KEY": "Api-Key YOUR_API_KEY_HERE"
91      }
92    }
93  }
94}
95```
96 
97## Example Usage
98 
99Once configured, you can ask questions like:
100 
101- "Show me the status of my recent interviews"
102- "Get the transcript from my last interview with candidate John Smith"
103- "What projects do I have available?"
104- "Show me details about the 'Senior Developer' interviewer"
105 
106## Available Tools
107 
108Our MCP server exposes tools with the `agentinterviews_` prefix. Some key tools include:
109 
110- `agentinterviews_list_projects`: List all your projects
111- `agentinterviews_get_interview`: Get details about a specific interview
112- `agentinterviews_list_interviewers`: List all your interviewers
113- `agentinterviews_get_transcript`: Get a transcript from an interview
114 
115## Security
116 
117The Agent Interviews MCP server requires your API key for authentication. This key is used to securely access your account data. Never share your API key or include it in public repositories.
118 
119## Support
120 
121If you encounter any issues or have questions:
122 
123- Check our [documentation](https://docs.agentinterviews.com/MCP/overview/)
124- Contact [support@agentinterviews.com](mailto:support@agentinterviews.com)
125- Open an issue in this repository
126 
127## License
128 
129This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
130 
131## Related Projects
132 
133- [Model Context Protocol](https://github.com/modelcontextprotocol/modelcontextprotocol)
134- [MCP Python SDK](https://github.com/modelcontextprotocol/python-sdk)
135- [MCP TypeScript SDK](https://github.com/modelcontextprotocol/typescript-sdk)
136