dpkdhingra91/aiia-mcp-server
🎖️ 🐍 ☁️ - Official MCP server for AI Interview Agents: create roles from a job description, screen and parse CVs, schedule and manage candidate voice interviews, send reminders, and read back scored reports with transcripts. Supports English, Hindi and other Indian languages.
Quick Install
{
"mcpServers": {
"dpkdhingra91-aiia-mcp-server": {
"command": "npx",
"args": [
"-y",
"dpkdhingra91-aiia-mcp-server"
]
}
}
}Using an AI coding agent (Claude Code, Cursor, etc.)? Copy a ready-made prompt that tells it to fetch the setup instructions and install this server for you.
Documentation Overview
AI Interview Agents — MCP Server
The official Model Context Protocol server for AI Interview Agents, a voice-AI hiring platform. It lets any MCP client (Claude, Cursor, custom agents) drive the recruiting workflow in natural language: create roles, screen CVs, schedule and manage candidate interviews, and read back scored reports with transcripts.
The live voice interview itself is out of scope here (that runs on a separate real-time service). This server triggers interviews and reads back the results.
What it exposes
- Roles — list your roles, or create one from a job description.
- Candidates & CVs — parse dropped CV/PDF files, normalize messy pasted candidate lists (names, emails, phone numbers, experience, skills), and reassign candidates between roles.
- Interviews — schedule interviews (with a
dry_runmode that normalizes and previews without sending anything or consuming quota), reschedule, cancel, and send reminders. - Reports — read the candidate pipeline and pull back scored interview reports with transcripts.
Use the hosted server (recommended)
The server runs remotely with OAuth sign-in. Point any Streamable-HTTP MCP client at:
{
"mcpServers": {
"ai-interview-agents": {
"type": "streamable-http",
"url": "https://mcp.aiinterviewagents.com/mcp"
}
}
}
Your client discovers the auth flow automatically via /.well-known/oauth-protected-resource and signs you in with your AI Interview Agents account. It is also listed in the official MCP Registry as com.aiinterviewagents/interviews.
Run it locally (stdio)
pip install -e .
export AIIA_FIREBASE_TOKEN="<your token>" # or: aiia-mcp login
aiia-mcp
AIIA_BACKEND_URL overrides the API base if you are pointing at your own deployment.
How auth works
The server holds no account secrets. Each request carries the user's own Firebase ID token, forwarded to the backend as a bearer token — the same trust path as the web app. For the hosted transport, an OAuth layer (dynamic client registration + PKCE) bridges MCP clients to Firebase sign-in.
Development
pip install -e ".[dev]"
pytest
ruff check .
License
MIT — see LICENSE.