MCP verb reference

The developerz.ai MCP server is live at mcp.developerz.ai. Connect it from Claude Code, Claude Desktop, or any MCP-capable client using a personal access token from the dashboard.

Trust model

Every MCP call is bound by the same rules as the rest of the platform:

The bot always discloses. Every action it takes is labelled as automated — it never impersonates a human.
Thin orchestrator, BYOK. Coding runs in your own agent; inference uses your own provider key. We never proxy or resell tokens.
Audit-first. Every tool call is written to the append-only audit log. If it isn't logged, it didn't happen.

Connecting

// .claude/settings.json (Claude Code)
{
  "mcpServers": {
    "developerz": {
      "command": "mcp-remote",
      "args": ["https://mcp.developerz.ai"],
      "env": { "MCP_BEARER_TOKEN": "dzai_live_…" }
    }
  }
}

Or direct HTTP (JSON-RPC 2.0 over POST /v1/mcp):

curl https://api.developerz.ai/v1/mcp \
  -H "Authorization: Bearer dzai_live_…" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"tools/call","id":1,"params":{"name":"whoami","arguments":{}}}'

User-tier tools

Flat, hot-path tools available to every authenticated account. No action field.

{/* BEGIN mcp-generated: verbs:flat */}

Tool	Scope	Description
`whoami`	(none)	Return caller account, MCP tier, and granted scopes.
`repo_ask`	`read:repos`	Grounded repo Q&A with citations — refuses rather than guessing when no citable evidence exists.
`kb_search`	`read:repos`	Search the repo knowledge base (agent-maintained wiki) — page slugs, scores, previews.
`kb_page_get`	`read:repos`	Read one KB wiki page verbatim by slug — body, cross-links, provenance.
`kb_page_upsert`	`write:repos`	Create or replace one KB wiki page by slug — the post-task write-back so learnings compound.
`task_create`	`write:tasks`	Dispatch a scoped task to a sink (`linear \| gh \| direct`). Returns `{task_id, sink, url}` or an escalation.
`message`	`write:sessions`	Send a message to a live interactive run (scout/setup) and await the agent reply.
`help`	(none)	List available tools, compact and role-filtered.
{/* END mcp-generated: verbs:flat */}

Operator-tier tools

Resource tools — one tool name, dispatched by an action field. Call describe_resource("<name>") in any MCP client to load the full per-action JSON Schema on demand. tools/list stays lean: one entry per resource instead of listing every action separately.

Consumer-or-absent. A tool only appears in tools/list when its backing service is configured. All tools below are available on platform-managed accounts.

Box

{/* BEGIN mcp-generated: verbs:box */}

Action	Scope	Description
`list`	`read:runners`	List fleet boxes.
`get`	`read:runners`	Get one box + live presence.
`fleet_status`	`read:runners`	Aggregated fleet status (counts + per-box line).
`add`	`write:runners`	Mint a one-time enrollment token.
`drain`	`write:runners`	Evacuate box; re-enqueue in-flight tasks.
`set_owner`	`write:runners`	Retarget a box `shared \| org \| user` (the runner-ownership model).
`set_prompt`	`write:runners`	Set/clear the box's concise briefing (what this VPS runs, ≤2000 chars).
{/* END mcp-generated: verbs:box */}

Project

{/* BEGIN mcp-generated: verbs:project */}

Action	Scope	Description
`list`	`read:repos`	List account repositories with enabled state.
`add`	`write:repos`	Enable an installed (but disabled) repo.
`create`	`write:repos`	Scaffold a brand-new gold-standard repo + AI fill (advertised only when backed).
`policy_get`	`read:repos`	Stored `.maintainer.yml` policy snapshot for one enabled repo.
`policy_validate`	`write:repos`	Pure `.maintainer.yml` check — nothing stored.
`overview`	`read:repos`	Activity rollup for one enabled repo (repo-detail tab).
`settings`	`read:repos`	Settings view for one enabled repo (repo-detail tab).
{/* END mcp-generated: verbs:project */}

Task

{/* BEGIN mcp-generated: verbs:task */}

Action	Scope	Description
`list`	`read:tasks`	List fleet task queue (supports `filters.status`, `per_page`).
`reassign`	`write:tasks`	Pull in-flight task off its box → `pending`.
`run_status`	`read:tasks`	One-row pulse for a task's run.
`run_tail`	`read:tasks`	Durable run events after `since_seq`, capped.
{/* END mcp-generated: verbs:task */}

Audit

{/* BEGIN mcp-generated: verbs:audit */}

Action	Scope	Description
`tail`	`read:sessions`	Recent maintainer-visible audit events, newest-first.
{/* END mcp-generated: verbs:audit */}

Template

{/* BEGIN mcp-generated: verbs:template */}

Action	Scope	Description
`list`	`read:runners`	List agent templates.
`get`	`read:runners`	Get one agent template by name.
`set`	`write:runners`	Create-or-replace (full upsert) an agent template.
`delete`	`write:runners`	Delete agent template (idempotent).
{/* END mcp-generated: verbs:template */}

Config

Scoped prompt-var KV — #{{key}} interpolation into agent prompts.

{/* BEGIN mcp-generated: verbs:config */}

Action	Scope	Description
`get`	`read:runners`	Read one prompt var (`account \| repo \| template` scope — specific wins).
`set`	`write:runners`	Set a prompt var (`#{{key}}` interpolation).
`list`	`read:runners`	List prompt vars for a scope.
{/* END mcp-generated: verbs:config */}

User

{/* BEGIN mcp-generated: verbs:user */}

Action	Scope	Description
`approve`	`admin:users`	Approve a waitlisted user for the closed beta (operator PAT only).
`suspend`	`admin:users`	Clear approval — return the user to the waitlist (idempotent).
{/* END mcp-generated: verbs:user */}

Account

{/* BEGIN mcp-generated: verbs:account */}

Action	Scope	Description
`me`	`read:account`	The `/v1/me` identity view (user, memberships, active account).
`active_account_switch`	`write:account`	Repoint the live user session at a member account.
`platform_overview`	`admin:read:platform`	Platform radar rollup (staff read).
`orgs_list`	`admin:read:orgs`	All org accounts (staff read).
`users_list`	`admin:read:users`	All users (staff read).
`set_tier`	`admin:accounts`	Operator override: set an account's tier by id.
`set_seats`	`admin:accounts`	Operator override: set an account's seat count.
`set_spend_cap`	`admin:accounts`	Operator override: set an account's spend cap.
{/* END mcp-generated: verbs:account */}

Review

AI code-review runs for a pull request (the PR rows themselves live on pr).

{/* BEGIN mcp-generated: verbs:review */}

Action	Scope	Description
`status`	`read:prs`	The PR's AI code-review runs, newest-first.
`rerun`	`write:prs`	Re-run the latest review on the same commit.
{/* END mcp-generated: verbs:review */}

CI

{/* BEGIN mcp-generated: verbs:ci */}

Action	Scope	Description
`runs`	`read:runners`	List self-hosted CI runs newest-first (`repo`/`status`/`per_page`).
`log_url`	`read:runners`	Short-lived presigned URL for one CI run's archived log.
{/* END mcp-generated: verbs:ci */}

Artifact

{/* BEGIN mcp-generated: verbs:artifact */}

Action	Scope	Description
`put`	`write:artifacts`	Register an artifact and get a presigned PUT URL (5-min TTL).
`get`	`read:artifacts`	Get a presigned download URL for an artifact (1-hour TTL).
`list`	`read:artifacts`	List artifacts for the account; filter by `task_id`, `run_id`, or `repo_id`.
`share`	`write:artifacts`	Mint a fresh presigned download URL for an existing artifact.
`delete`	`write:artifacts`	Delete an artifact immediately (soft-delete for 24 h, then purged).
{/* END mcp-generated: verbs:artifact */}

Issue

{/* BEGIN mcp-generated: verbs:issue */}

Action	Scope	Description
`list`	`read:issues`	One enabled repo's issues newest-first (`state`/`qualification`/`q`/`per_page`).
`get`	`read:issues`	One issue by id.
`handoff`	`write:issues`	Force-fire the issue to the coding-agent webhook (queued delivery; `reason` + optional `webhook_ref`).
`escalate`	`write:issues`	Force-pull a human in (`category` + `reason` → escalation row + notification).
{/* END mcp-generated: verbs:issue */}

Pull request

{/* BEGIN mcp-generated: verbs:pr */}

Action	Scope	Description
`list`	`read:prs`	One enabled repo's PRs newest-first (`state`/`ci_status`/`per_page`).
`get`	`read:prs`	One PR by id.
`approve_pending`	`write:prs`	Approve the PR's outstanding ask-before-acting.
`skip_pending`	`write:prs`	Decline the PR's outstanding ask-before-acting.
{/* END mcp-generated: verbs:pr */}

Dashboard

{/* BEGIN mcp-generated: verbs:dashboard */}

Action	Scope	Description
`list`	`read:dashboards`	List account-shared boards.
`get`	`read:dashboards`	Get a board with all widget specs.
`upsert`	`write:dashboards`	Create or fully replace a named board (idempotent by name).
`delete`	`write:dashboards`	Delete a board (idempotent).
{/* END mcp-generated: verbs:dashboard */}

Donation

{/* BEGIN mcp-generated: verbs:donation */}

Action	Scope	Description
`create`	`write:donations`	Donate `money \| compute \| llm` — earmarks the resource oss-only.
`list`	`read:donations`	List the account's donations.
`cancel`	`write:donations`	Detach a donation (idempotent).
{/* END mcp-generated: verbs:donation */}

Integration

{/* BEGIN mcp-generated: verbs:integration */}

Action	Scope	Description
`list`	`read:integrations`	List the account's connected integrations (status only; credentials never cross the boundary).
`get`	`read:integrations`	Get one connector by kind (status only; never echoes the secret).
`disconnect`	`write:integrations`	Disconnect a connector: drops the row and its vault secret. No connect verb — credentials stay dashboard-only.
{/* END mcp-generated: verbs:integration */}

Digest

{/* BEGIN mcp-generated: verbs:digest */}

Action	Scope	Description
`list`	`read:digests`	Digest header rows newest-first (`per_page` cap).
`get`	`read:digests`	One digest with `rendered_html`.
{/* END mcp-generated: verbs:digest */}

Billing

{/* BEGIN mcp-generated: verbs:billing */}

Action	Scope	Description
`keys_list`	`read:billing`	List BYOK keys (masked).
`key_add`	`write:billing`	Add a BYOK key — sealed + captured, never echoed.
`key_delete`	`write:billing`	Delete a BYOK key.
`key_verify`	`write:billing`	Verify a key against its provider (live probe).
`usage`	`read:billing`	Usage rollup for the current billing window.
`entitlements`	`read:billing`	The account's tier entitlements.
`portal`	`write:billing`	Mint a Stripe billing-portal URL.
`set_cap`	`write:billing`	Set the monthly spend cap.
`log_sink_get`	`read:billing`	Read the LLM-log sink config.
`log_sink_set`	`write:billing`	Set the LLM-log sink (validate + probe + seal).
`log_sink_clear`	`write:billing`	Clear the LLM-log sink.
{/* END mcp-generated: verbs:billing */}

Email route

{/* BEGIN mcp-generated: verbs:email_route */}

Action	Scope	Description
`list`	`read:account`	The resolved notification category → address matrix.
`set`	`write:account`	Override one category's route.
`delete`	`write:account`	Clear an override (back to the default).
{/* END mcp-generated: verbs:email_route */}

Token

{/* BEGIN mcp-generated: verbs:token */}

Action	Scope	Description
`list`	`read:account`	List PATs (masked rows incl. revoked).
`mint`	`write:account`	Mint a PAT (subset-of-caller scopes; plaintext returned ONCE).
`revoke`	`write:account`	Revoke a PAT.
{/* END mcp-generated: verbs:token */}

Scopes

PATs carry only the scopes you select at creation time. Dashboard session cookies grant all scopes. Scope names follow read|write:<resource>.

Scope	Grants
`read:repos` / `write:repos`	Repos + project management + KB
`read:tasks` / `write:tasks`	Fleet task queue
`read:runners` / `write:runners`	Boxes + templates + config + CI
`read:sessions` / `write:sessions`	Audit log + interactive runs
`read:issues` / `write:issues`	Tracked issues + forced handoff/escalate
`read:prs` / `write:prs`	PR review + pending decisions
`read:artifacts` / `write:artifacts`	Artifact storage
`read:dashboards` / `write:dashboards`	Realtime boards
`read:donations` / `write:donations`	OSS donations
`read:digests`	Weekly-digest archive
`read:billing` / `write:billing`	BYOK keys, usage, billing controls
`read:account` / `write:account`	Identity view, account switch, email routes, PATs
`admin:users`	Closed-beta user approval (staff only)
`admin:accounts`	Operator account overrides (staff only)
`admin:read:platform` / `admin:read:orgs` / `admin:read:users`	Platform radar reads (staff only)

Verb tables on this page are generated from the MCP catalog (FLAT_TOOL_SCOPES + ARMY_ACTION_SCOPES in @developerz/mcp) by bun run mcp:doc; headings and prose are hand-curated. The same matrix is embedded in docs/idea/api.md + docs/idea/mcp.md.