Praxicraft Assess — hiring workspace docs

MCP (Model Context Protocol) lets an AI coding agent use Assess tools — create assessments, invite candidates, read results — with your permission. For docs search + skills + one-click install across agents, see Build with agents (Knowledge MCP is separate from this API server).

If you are not an engineer

You typically do not need MCP. Use the dashboard or ask an engineer to set up n8n / Automations. MCP is for people already working in a coding agent who want it to operate Assess safely.

Two ways to connect

Mode	Best for	How you sign in
Hosted HTTP	Interactive IDE sessions	Browser OAuth at `https://assess.praxicraft.com/mcp` (always live mode). Owners, admins, and developers can consent.
Stdio package	CI / locked-down machines / Test mode	Env var `PRAXICRAFT_API_KEY` (`ct_live_…` or `ct_test_…`) via `npx -y @praxicraft/assess-mcp`

The stdio package is @praxicraft/assess-mcp on npm. Hosted HTTP runs at https://assess.praxicraft.com/mcp. Prefer least-privilege scopes on stored keys. IP allowlists on API keys apply to Public API ct_live_… / ct_test_… requests only. Hosted MCP OAuth is not IP-restricted. If you use stdio MCP with PRAXICRAFT_API_KEY, leave that key’s CIDR list empty (or use a dedicated MCP key).

Setup by IDE

Pick your client. Hosted HTTP uses browser OAuth (live mode). Stdio uses an API key — prefer ct_test_… while developing. Want Knowledge MCP + hiring skills in one install? Use the Agent Plugin instead.

Open MCP settings

In Cursor: Settings → MCP (or edit .cursor/mcp.json in your project / home Cursor config).

Add the hosted Assess server

{
  "mcpServers": {
    "praxicraft-assess": {
      "url": "https://assess.praxicraft.com/mcp"
    }
  }
}

Restart Cursor and approve OAuth

Enable the server if prompted. On the first Assess tool call, complete the browser consent screen (owners, admins, and developers).

Try it

Ask: “List my Assess assessments.” For the full plugin (docs + skills), see Build with agents → Cursor.

Open Claude Code MCP config

Add an HTTP MCP server in your Claude Code settings (or project MCP config). Claude Code expects "type": "http".

Paste the Assess server

{
  "mcpServers": {
    "praxicraft-assess": {
      "type": "http",
      "url": "https://assess.praxicraft.com/mcp"
    }
  }
}

Reload and approve OAuth

Restart or reload MCP. The first tool call opens browser consent for live Assess access.

Optional: install the Agent Plugin

Marketplace install also wires Knowledge MCP + skills: Build with agents → Claude Code.

Add hosted MCP to Codex

Configure MCP with the same hosted URL as Cursor:

{
  "mcpServers": {
    "praxicraft-assess": {
      "url": "https://assess.praxicraft.com/mcp"
    }
  }
}

Restart Codex and approve OAuth

On the first Assess tool call, sign in in the browser (live mode).

Optional: Agent Plugin

For skills + Knowledge MCP: Build with agents → Codex CLI.

Open Copilot Chat MCP settings

In VS Code with GitHub Copilot Chat, open MCP / agent settings (or your workspace MCP config file).

{
  "mcpServers": {
    "praxicraft-assess": {
      "url": "https://assess.praxicraft.com/mcp"
    }
  }
}

Reload the window

Reload VS Code if the tools do not appear. Approve OAuth on the first Assess tool call.

Optional: Agent Plugin folder

Clone the plugin and add it under Chat → Plugins for skills: Build with agents → VS Code.

Antigravity (IDE / CLI / 2.0) uses serverUrl for remote MCP — not url. Config lives in ~/.gemini/config/mcp_config.json (global) or .agents/mcp_config.json (workspace).

Open MCP config

In Antigravity IDE: open the agent side panel → … → MCP Servers → Manage MCP Servers → View raw config.Or edit the file directly:

Scope	Path
Global	`~/.gemini/config/mcp_config.json`
Workspace	`.agents/mcp_config.json`

Add Assess (hosted HTTP)

{
  "mcpServers": {
    "praxicraft-assess": {
      "serverUrl": "https://assess.praxicraft.com/mcp"
    },
    "praxicraft-assess-knowledge": {
      "serverUrl": "https://docs.praxicraft.com/mcp"
    }
  }
}

Knowledge MCP needs no credentials. API MCP uses browser OAuth (live mode) on first tool use.

Refresh and authenticate

In Installed MCP Servers, click Refresh. For the API server, complete any Authenticate / OAuth prompt when Antigravity asks.

Try it

Ask: “List my Assess assessments.” For Test mode, use stdio instead (see the Stdio / Test mode tab) with command / args / env in the same mcp_config.json.

Optional: skills

Antigravity does not use the Cursor/Claude plugin marketplaces. Install hiring skills with:

npx skills add praxicraft-platform/praxicraft-assess-agent-plugin

Or see Build with agents → Antigravity.

Create an Assess API key

In Assess go to Developer → API Keys. Create a key and copy it once. Use ct_test_… while developing; ct_live_… for production.

Open the Claude Desktop config file

Claude Desktop reads MCP servers from claude_desktop_config.json:

OS	Path
macOS	`~/Library/Application Support/Claude/claude_desktop_config.json`
Windows	`%APPDATA%\Claude\claude_desktop_config.json`

Create the file if it does not exist yet.

Add the stdio Assess MCP server

Requires Node.js 18+ on your PATH (npx must work in a terminal).

{
  "mcpServers": {
    "praxicraft-assess": {
      "command": "npx",
      "args": ["-y", "@praxicraft/assess-mcp"],
      "env": {
        "PRAXICRAFT_API_KEY": "ct_test_xxxxxxxxxxxxxxxx"
      }
    }
  }
}

Replace the placeholder with your real key. Never commit this file if it contains a live key.

Fully quit and reopen Claude Desktop

Quit the app (not just the window), reopen, then ask: “List my Assess assessments.” If tools are missing, confirm Node works in Terminal and that the JSON is valid.

Hosted OAuth is not the usual path in Claude Desktop. Stdio + API key is the supported setup here. For Test vs Live behaviour, see Live and Test mode.

Gemini CLI has no agent-skill primitive. This path installs the MCP servers only (API + Knowledge via the Agent Plugin extension layout).

Clone into Gemini extensions

git clone https://github.com/praxicraft-platform/praxicraft-assess-agent-plugin.git \
  ~/.gemini/extensions/praxicraft-assess

Restart Gemini CLI

Confirm Assess tools appear. API MCP uses hosted OAuth on first use unless you switch to stdio.

Optional: skills elsewhere

Install skills with npx skills add or another IDE — Build with agents → Gemini.

Create a test API key

Developer → API Keys → create a ct_test_… key. Leave IP allowlist empty (or use a dedicated MCP key).

Add stdio MCP to any client

{
  "mcpServers": {
    "praxicraft-assess": {
      "command": "npx",
      "args": ["-y", "@praxicraft/assess-mcp"],
      "env": {
        "PRAXICRAFT_API_KEY": "ct_test_xxxxxxxxxxxxxxxx"
      }
    }
  }
}

Confirm Node 18+

npx -y @praxicraft/assess-mcp must run in a terminal on the same machine as the client.

Use Test data only

Hosted OAuth is always live. Stdio with ct_test_… is how you keep invites and webhooks off production destinations. Details: Live and Test mode.

What agents can do

Tools map to the Public API: assessments, invites, results, org/squads/audit (audit is Starter+), tasks, webhooks, interviews, pipelines, integrations. Remind agents to respect plan limits and to branch on error.code. Errors.

Build with agents · Using docs with LLMs · Quickstart · API Reference

Overview

ATS

Chat destinations

Automations & agents

MCP (Coding Agents)

If you are not an engineer

Two ways to connect

Setup by IDE

What agents can do

Next

​If you are not an engineer

​Two ways to connect

​Setup by IDE

​What agents can do

​Next

If you are not an engineer

Two ways to connect

Setup by IDE

What agents can do

Next