# dpkdhingra91/aiia-mcp-server [Health: Active]

**Category:** 🏢 Workplace & Productivity  
**Repository:** https://github.com/dpkdhingra91/aiia-mcp-server  
**GitHub Stars:** 0  
**Views:** 2  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/dpkdhingra91-aiia-mcp-server

## Description
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.

## Claude Desktop Quick Installation
Heuristic fallback — verify the package name and runner against the repository README before running it. Uses `npx` (confidence: low):

```json
"mcpServers": {
  "aiia-mcp-server": {
    "command": "npx",
    "args": ["-y","dpkdhingra91-aiia-mcp-server"],
    "env": {
      "AIIA_FIREBASE_TOKEN": "",
      "AIIA_BACKEND_URL": ""
    }
  }
}
```

**Requires environment variables:** `AIIA_FIREBASE_TOKEN`, `AIIA_BACKEND_URL` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation & README

# AI Interview Agents — MCP Server

[![aiia-mcp-server MCP server](https://glama.ai/mcp/servers/dpkdhingra91/aiia-mcp-server/badges/score.svg)](https://glama.ai/mcp/servers/dpkdhingra91/aiia-mcp-server)

The official [Model Context Protocol](https://modelcontextprotocol.io) server for [AI Interview Agents](https://www.aiinterviewagents.com), 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_run` mode 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:

```json
{
  "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](https://registry.modelcontextprotocol.io) as `com.aiinterviewagents/interviews`.

## Run it locally (stdio)

```bash
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

```bash
pip install -e ".[dev]"
pytest
ruff check .
```

## License

MIT — see [LICENSE](https://github.com/dpkdhingra91/aiia-mcp-server/blob/HEAD/LICENSE).