Create an API key, then use one sentence to connect Codex App, Claude App, or another MCP client to Interview Materials, plans, and reviews.
Agent API & MCP Integration
Agent API connects Interview AiBox Interview Materials, plans, real transcripts, and review capabilities to Codex App, Claude App/Claude Code, or another remote-MCP client. You do not need to learn the API first: create a key, then give the sentence below to the Agent you are using.
Connect with one sentence
Create an API key
Open Settings โ AI access & Agent API โ Create API key. Read-only permissions are a good first choice; copy the full key immediately after creation.
Send this sentence with the key
In a private conversation with Codex App, Claude App, or Claude Code, copy the prompt below and replace paste the full key with the key you just created:
Please connect Interview AiBox MCP. API key: paste the full key. Endpoint: https://api.interviewaibox.co/api/agent/mcp. Complete the configuration and verify that interview_aibox_* tools are available. Do not echo the key in your reply, a repository, or a public file. Report only the setup result.
Restart the client if the Agent asks you to. Once interview_aibox_* appears in the tool list, you can use natural language.
The verified initializer is also available at https://interviewaibox.co/setup-agent-mcp.mjs; keep the key in the INTERVIEW_AIBOX_AGENT_API_KEY environment variable and pass it as ${INTERVIEW_AIBOX_AGENT_API_KEY} when a shell example needs the value.
Send the key only to the Agent you are configuring
It is fine to paste the full key into a private conversation with the trusted Codex App or Claude App, but never post it in a group chat, public page, screenshot, or repository. The key is shown once; revoke and replace it immediately if exposed.
If the Agent cannot configure it: manual setup
Add a remote MCP server in the client. Use Endpoint https://api.interviewaibox.co/api/agent/mcp and request header Authorization: Bearer <your API key>. Save, restart the client, and verify that interview_aibox_* tools appear.
What to ask after connecting
Review the latest interview
Read the real transcript from my latest completed interview. Tell me which answers affected quality and organize the result as โquestion โ evidence in my answer โ why it was weak โ next practice.โ Do not invent anything absent from the transcript. If a formal review uses quota, ask for my confirmation first.
Prepare for the next interview
Find my next Interview Plan. Use its linked candidate material, role material, and supporting knowledge to list the most important preparation points, missing stories, and likely follow-ups. Use only real experience present in the materials.
Create an Interview Plan
Prepare an Interview Plan for next Wednesday and link the candidate material, role material, and supporting knowledge I specify. Show the company, role, time, and linked materials first, then wait for my confirmation before creating it.
Choose permissions
| What you want to do | Suggested permissions |
|---|---|
| View account and usage | account:read, usage:read |
| Read resumes and role material | resumes:read, job_descriptions:read |
| Read supporting knowledge | knowledge:read |
| View interviews, real transcripts, and existing reviews | interviews:read |
| Generate a formal review | interviews:analyze |
| Read or create Interview Plans | plans:read, plans:write |
| Edit or archive interview records | interviews:write, interviews:delete |
Start with read-only permissions if you are unsure. Before a write, archive, or formal-review action, ask the Agent to show the operation and wait for your confirmation.
Complete preparation to review flow
Use interview_aibox_interview_create to prepare a draft, then call interview_aibox_plan_create with the returned interview ID and the selected material IDs. After the Desktop session ends, call interview_aibox_interview_get with "include": "transcript,review", confirm the evidence with the user, and call interview_aibox_interview_analyze. Keep agent-only notes in metadata.notes; use interview_aibox_plan_update for the next plan's preparation fields.
Troubleshooting
Interview AiBox does not appear in the tool list
Restart the client if requested, confirm remote HTTP MCP support, check the endpoint, and make sure the newly created key is still saved in the local client configuration.
Permission denied
Create a new key with the required permissions. Existing keys do not gain permissions automatically.
Key exposed
Revoke it immediately in Settings and create a replacement.
Endpoint returns 404
The Agent API may not be enabled or the deployment may not be synchronized in this environment; it is not necessarily a key error. Contact support or try again later.
Continue reading
AI Reading Assistant
Send to your preferred AI
Smart Summary
Deep Analysis
Key Topics
Insights