Production-safety audits for AI-generated code, with a fix for every finding.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Paid nittim AI audit of a GitHub repository: one structured pass over the highest-signal source; the only tool here that returns scores and a verdict. Answers with the audit's id, not the report. `fullScan: true` buys the wider Full Audit tier. NEEDS A KEY: mint one at https://nittim.com/keys. COSTS MONEY in three calls: the first quotes a price and charges nothing; a second with `confirmedCost` set to that exact price returns a one-time link for the ACCOUNT OWNER to confirm — their yes, not the assistant's; a plain third call with the same arguments runs once at that price. A moved price is re-quoted, never charged.DELIVERED AS A BATCH: the report lands Usually within 15 minutes*. * Most reports land within 15 minutes. Worst case, 24 hours.
GitHub repository URL or owner/repo. A private repo needs a githubToken, unless the account has installed nittim's GitHub App at nittim.com for it.
True buys the wider Full Audit tier: every eligible source file, priced by pass count.
True pays credits now instead of queuing for the daily free-audit budget to reopen, skipping the covered (Audit) entitlement even when it would otherwise be free.
Optional URL of this repository's live deployment, for an origin the account owner actually operates. When set, the audit adds one bounded, READ-ONLY fetch pass against it and reports drift between the deployed artifact and the audited commit. Redirects are never followed; private addresses are refused.
Optional read-only GitHub token for a private repo. Without one, only public repos are reachable — unless the account has installed nittim's GitHub App at nittim.com for this repo, in which case a private repo works with no token at all.
HUMAN CONFIRMATION. The `authorization` id from the confirm-link answer, once the account owner has pressed Confirm. Single-use, short TTL.
COST CONFIRMATION. Omit on the first call; then send back the exact quoted `cost`.
This tool isn't marked read-only, so it may change something on the server or in an account you connected.
Paid nittim AI audit of a GitHub repository: one structured pass over the highest-signal source; the only tool here that returns scores and a verdict. Answers with the audit's id, not the report. `fullScan: true` buys the wider Full Audit tier. NEEDS A KEY: mint one at https://nittim.com/keys. COSTS MONEY in three calls: the first quotes a price and charges nothing; a second with `confirmedCost` set to that exact price returns a one-time link for the ACCOUNT OWNER to confirm — their yes, not the assistant's; a plain third call with the same arguments runs once at that price. A moved price is re-quoted, never charged.DELIVERED AS A BATCH: the report lands Usually within 15 minutes*. * Most reports land within 15 minutes. Worst case, 24 hours.
| Argument | Type | Description |
|---|---|---|
| repoUrl* | string | GitHub repository URL or owner/repo. A private repo needs a githubToken, unless the account has installed nittim's GitHub App at nittim.com for it. |
| fullScan | boolean | True buys the wider Full Audit tier: every eligible source file, priced by pass count. |
| payInstead | boolean | True pays credits now instead of queuing for the daily free-audit budget to reopen, skipping the covered (Audit) entitlement even when it would otherwise be free. |
| deployedUrl | string | Optional URL of this repository's live deployment, for an origin the account owner actually operates. When set, the audit adds one bounded, READ-ONLY fetch pass against it and reports drift between the deployed artifact and the audited commit. Redirects are never followed; private addresses are refused. |
| githubToken | string | Optional read-only GitHub token for a private repo. Without one, only public repos are reachable — unless the account has installed nittim's GitHub App at nittim.com for this repo, in which case a private repo works with no token at all. |
| authorization | string | HUMAN CONFIRMATION. The `authorization` id from the confirm-link answer, once the account owner has pressed Confirm. Single-use, short TTL. |
| confirmedCost | object | COST CONFIRMATION. Omit on the first call; then send back the exact quoted `cost`. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"repoUrl"
],
"properties": {
"repoUrl": {
"type": "string",
"minLength": 1,
"description": "GitHub repository URL or owner/repo. A private repo needs a githubToken, unless the account has installed nittim's GitHub App at nittim.com for it."
},
"fullScan": {
"type": "boolean",
"description": "True buys the wider Full Audit tier: every eligible source file, priced by pass count."
},
"payInstead": {
"type": "boolean",
"description": "True pays credits now instead of queuing for the daily free-audit budget to reopen, skipping the covered (Audit) entitlement even when it would otherwise be free."
},
"deployedUrl": {
"type": "string",
"description": "Optional URL of this repository's live deployment, for an origin the account owner actually operates. When set, the audit adds one bounded, READ-ONLY fetch pass against it and reports drift between the deployed artifact and the audited commit. Redirects are never followed; private addresses are refused."
},
"githubToken": {
"type": "string",
"description": "Optional read-only GitHub token for a private repo. Without one, only public repos are reachable — unless the account has installed nittim's GitHub App at nittim.com for this repo, in which case a private repo works with no token at all."
},
"authorization": {
"type": "string",
"description": "HUMAN CONFIRMATION. The `authorization` id from the confirm-link answer, once the account owner has pressed Confirm. Single-use, short TTL."
},
"confirmedCost": {
"type": "object",
"required": [
"kind",
"credits"
],
"properties": {
"kind": {
"type": "string",
"description": "The `kind` from the quoted cost, e.g. 'credits'."
},
"credits": {
"type": "number",
"description": "The `credits` number from the quoted cost."
},
"centicredits": {
"type": "number",
"description": "The `centicredits` integer from the quoted cost, if it carried one."
}
},
"description": "COST CONFIRMATION. Omit on the first call; then send back the exact quoted `cost`."
}
}
}Paid nittim AI audit of source files you post, for a project with no GitHub remote. Send SOURCE files, not build output — no node_modules or dist. On nittim's own key this answers with the audit's id; the report lands Usually within 15 minutes*. * Most reports land within 15 minutes. Worst case, 24 hours. On your own key (BYOK Pro) the report comes back in this call instead. Costs 5.14 credits (a paid+subscribed org's included allowance, an unspent Audit, then prepaid credits), always saved as a PRIVATE report. `fullScan: true` buys the wider Full Audit tier. NEEDS A KEY: mint one at https://nittim.com/keys. COSTS MONEY in three calls: the first quotes a price and charges nothing; a second with `confirmedCost` set to that exact price returns a one-time link for the ACCOUNT OWNER to confirm — their yes, not the assistant's; a plain third call with the same arguments runs once at that price. A moved price is re-quoted, never charged.
| Argument | Type | Description |
|---|---|---|
| name* | string | A display label for this project, e.g. 'my-abacus-app'. Sanitized before use. |
| files* | array | Source files as { path, content }[] — not build output. At most 1000; over the internal per-audit cap, the highest-priority ones win. |
| fullScan | boolean | True buys the wider Full Audit tier over the files you post, priced by pass count. |
| uploadGrant | string | Optional: the id of an upload approval the account owner already confirmed. A large post without one is answered with a confirmation covering the files and the price. |
| authorization | string |
How this server works, in full: how a paid call quotes and charges, the two audit tiers, the Nittim Loop and its reward rules and caps, and dispute guidance. Free, no key, no charge, no side effects — it reads static text and calls no model. `section` picks one page; omitted, it returns all of them.
| Argument | Type | Description |
|---|---|---|
| section | string | Which page: money, tiers, loop, disputes, or all (the default). |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"section": {
"enum": [
"money",
"tiers",
"loop",
"disputes",
"all"
],
"type": "string",
"description": "Which page: money, tiers, loop, disputes, or all (the default)."
}
}
}NEEDS A KEY: mint one at https://nittim.com/keys. Records that a finding from a prior audit is wrong (stance:'dispute') or genuinely real (stance:'confirm'), backed by evidence from the repo. Free. A SIGNAL for owner triage — it never changes the audit's scores, verdict or stored report on its own. The finding is identified by its findingKey (from the digest), or by its exact dimension and title.
| Argument | Type | Description |
|---|---|---|
| title | string | The finding's exact title — required if findingKey is omitted. |
| stance* | string | 'dispute' = this finding is wrong. 'confirm' = this finding is genuinely real. |
| auditId* | string | The audit UUID, from its report link. |
| evidence* | object | What you can see in the repo that supports your stance. |
| dimension | string | The finding's dimension, e.g. 'security' — required if findingKey is omitted. |
| findingKey | string | The finding's stable key from the digest, if you have it (preferred over dimension+title). |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"auditId",
"stance",
"evidence"
],
"properties": {
"title": {
"type": "string",
"description": "The finding's exact title — required if findingKey is omitted."
},
"stance": {
"enum": [
"dispute",
"confirm"
],
"type": "string",
"description": "'dispute' = this finding is wrong. 'confirm' = this finding is genuinely real."
},
"auditId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"description": "The audit UUID, from its report link."
},
"evidence": {
"type": "object",
"required": [
"file",
"explanation"
],
"properties": {
"file": {
"type": "string",
"minLength": 1,
"description": "The file path your evidence points to."
},
"lines": {
"type": "string",
"description": "Line range, e.g. '42-58'."
},
"snippet": {
"type": "string",
"description": "A short excerpt of the actual code supporting your stance."
},
"explanation": {
"type": "string",
"minLength": 1,
"description": "Why this finding is wrong or confirmed real, in your own words."
}
},
"description": "What you can see in the repo that supports your stance."
},
"dimension": {
"type": "string",
"description": "The finding's dimension, e.g. 'security' — required if findingKey is omitted."
},
"findingKey": {
"type": "string",
"description": "The finding's stable key from the digest, if you have it (preferred over dimension+title)."
}
}
}Price an audit before buying one: give a GitHub repository URL, or a manifest of paths and byte sizes — no file content, nothing uploaded — and get the tier (Audit or Full Audit), the pass count and the exact price. No account or key is needed: it never charges, runs no audit, calls no model and stores nothing. Signed in it also returns your credit balance and whether an unspent Audit covers the run; a guest quote omits both. `fullScan: true` prices Full Audit.
| Argument | Type | Description |
|---|---|---|
| files | array | A manifest of paths and sizes only, in place of `repoUrl` — the same set you would post. Over the cap the answer names it and how to trim. Send one or the other. |
| repoUrl | string | GitHub repository URL or owner/repo. Mutually exclusive with `files` — send one. |
| fullScan | boolean | Price Full Audit (every eligible file, or a refusal with the reason when the selection is too large) instead of the default Audit. |
| githubToken | string | Optional GitHub personal access token (read-only) for a private repo. Without one, a signed-in account with nittim's GitHub App installed at nittim.com for this repo still prices it — no token needed. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"files": {
"type": "array",
"items": {
"type": "object",
"required": [
"path",
"bytes"
],
"properties": {
"path": {
"type": "string",
"minLength": 1,
"description": "Relative path, e.g. 'src/index.ts'."
},
"bytes": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "The file's byte size. This shape has no `content` — nothing is uploaded."
}
}
},
"minItems": 1,
"description": "A manifest of paths and sizes only, in place of `repoUrl` — the same set you would post. Over the cap the answer names it and how to trim. Send one or the other."
},
"repoUrl": {
"type": "string",
"minLength": 1,
"description": "GitHub repository URL or owner/repo. Mutually exclusive with `files` — send one."
},
"fullScan": {
"type": "boolean",
"description": "Price Full Audit (every eligible file, or a refusal with the reason when the selection is too large) instead of the default Audit."
},
"githubToken": {
"type": "string",
"description": "Optional GitHub personal access token (read-only) for a private repo. Without one, a signed-in account with nittim's GitHub App installed at nittim.com for this repo still prices it — no token needed."
}
}
}Retrieve a nittim audit by its UUID, at any stage: the finished markdown digest (verdict, scores, top findings) plus its report link, or — no error, nothing charged — that it is still running, or why it failed and what happened to the charge. Free. An audit of a public repository reads without a key; a private one needs the key of the account that owns it.
| Argument | Type | Description |
|---|---|---|
| id* | string | The UUID of the saved audit, from the /report/{id} URL. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"description": "The UUID of the saved audit, from the /report/{id} URL."
}
}
}Returns the current text of nittim's free, tool-agnostic self-review checklist — the same content served at https://nittim.com/selfcheck.md. Reviews a codebase against the public shape of nittim's 13-category Priority Framework, plus a 14th on what the code gives away, and states the procedure for running it as a loop. No arguments. No key, no account and no charge — nothing here is sent anywhere.
No arguments.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}Run a cross-vendor judge model over any text you post: code, a document, another model's output, anything. Returns findings + rationale ONLY — never a score, never a pass/fail verdict. Costs 5.03 credits. The judge always comes from a different vendor family than whatever produced the content, and the answer says which one ran. `modelUnderTest` names that family. NEEDS A KEY: mint one at https://nittim.com/keys. COSTS MONEY in three calls: the first quotes a price and charges nothing; a second with `confirmedCost` set to that exact price returns a one-time link for the ACCOUNT OWNER to confirm — their yes, not the assistant's; a plain third call with the same arguments runs once at that price. A moved price is re-quoted, never charged.
| Argument | Type | Description |
|---|---|---|
| content* | string | The text to judge — code, a document, another model's output. Up to ~100KB. |
| context | string | Optional — background the judge should know, e.g. what this content is for. |
| criteria | string | Optional — what to judge it against, e.g. 'correctness and security'. |
| authorization | string | HUMAN CONFIRMATION. The `authorization` id from the confirm-link answer, once the account owner has pressed Confirm. Single-use, short TTL. |
| confirmedCost | object | COST CONFIRMATION. Omit on the first call; then send back the exact quoted `cost`. |
| modelUnderTest | string | Optional — which vendor family produced `content`, if it is itself a model's output. The judge that runs is always a different family than this names. Use 'unspecified' for anything that is not model output, or when the family is unknown. |
List every audit module nittim can run: the two deterministic scanners (secret scan + OSV dependency CVE check) and the LLM-reasoned checks. Returns each module's key, tier, and a plain-English description of what it checks. Each module's key identifies it for running individually.
No arguments.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}For a client that cannot sign in over OAuth: a short, one-time link to https://nittim.com/keys/claim/<token>. Opening it, signed in, mints a real nittim API key and shows it once — the key itself is NEVER returned by this tool or by any other MCP result. The link expires in a few minutes and works exactly once. Free.
| Argument | Type | Description |
|---|---|---|
| keyName | string | Optional display name for the key that will be minted, e.g. 'my-cursor-key'. Defaults to 'API key'. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"keyName": {
"type": "string",
"maxLength": 80,
"description": "Optional display name for the key that will be minted, e.g. 'my-cursor-key'. Defaults to 'API key'."
}
}
}NEEDS A KEY: mint one at https://nittim.com/keys. Send the paths and sizes of the files you would post — no content leaves your machine to ask this — and get back the list, the byte count, and a link for the account owner to approve it. Free. The approval covers that file list and no other, and a paid audit's own confirmation already covers the file list beside the price, so approving ahead of time is optional.
| Argument | Type | Description |
|---|---|---|
| name* | string | A display label for this project, e.g. 'my-abacus-app'. Sanitized before use. |
| files* | array | Paths and sizes only — the same set you would post. Never file content. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"name",
"files"
],
"properties": {
"name": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "A display label for this project, e.g. 'my-abacus-app'. Sanitized before use."
},
"files": {
"type": "array",
"items": {
"type": "object",
"required": [
"path",
"bytes"
],
"properties": {
"path": {
"type": "string",
"minLength": 1,
"description": "Relative path, e.g. 'src/index.ts'."
},
"bytes": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "The file's size in bytes. No content."
}
}
},
"maxItems": 1000,
"minItems": 1,
"description": "Paths and sizes only — the same set you would post. Never file content."
}
}
}NEEDS A KEY: mint one at https://nittim.com/keys. Records anonymised counts from a Nittim Loop the developer has finished and agreed to send: pass numbers, a findings-by-category tally, a fixed count, and whether each pass was clean. Counts only — never a title, file path or snippet. Nothing is charged, and an eligible report can earn a credit reward (rules and caps: see describe_protocol). Reporting the same repo again updates the existing record; the reply says which happened. Results appear at https://nittim.com/loop.
| Argument | Type | Description |
|---|---|---|
| mode | string | Optional: 'one_shot' (every lens sweeps the whole tree first, then one fix wave, then a short convergence loop) or 'serial' (one lens or area per pass, fixing between passes). |
| swept | boolean | Optional: was the CLASS swept — a guard, lint rule or exhaustiveness check that makes a new instance loud — rather than only the instances a pass named? Never derived, never changes the reward. On a repeat report, omitting it keeps the last answer; `false` withdraws it. |
| passes* | array | One entry per pass you actually ran, in order. |
| repo_hash* | string | sha256 of the repository's canonical identity (the lowercased 'owner/repo', or a stable local fingerprint) — never the repo name itself. nittim never sees the name. |
| client_name | string | Your own name — omit to read it from the MCP connection instead. |
| convergence | string |
Run ONE nittim audit module against a GitHub repository, never producing scores or a verdict. The two deterministic modules (secret-scan, dependency-cve) return scanner evidence directly, free, with nothing to confirm. Deep-tier modules make one focused model call, cost 5.03 credits each and follow the protocol below. NEEDS A KEY: mint one at https://nittim.com/keys. COSTS MONEY in three calls: the first quotes a price and charges nothing; a second with `confirmedCost` set to that exact price returns a one-time link for the ACCOUNT OWNER to confirm — their yes, not the assistant's; a plain third call with the same arguments runs once at that price. A moved price is re-quoted, never charged.
| Argument | Type | Description |
|---|---|---|
| repoUrl* | string | GitHub repository URL or owner/repo. A private repo needs a githubToken. |
| moduleKey* | string | The module's key, e.g. 'secret-scan', 'dependency-cve', 'security', 'privacy', 'gdpr'. |
| githubToken | string | Optional read-only GitHub token. Without one, only public repos are reachable. |
| authorization | string | HUMAN CONFIRMATION. The `authorization` id from the confirm-link answer, once the account owner has pressed Confirm. Single-use, short TTL. |
| confirmedCost | object | COST CONFIRMATION. Omit on the first call; then send back the exact quoted `cost`. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"repoUrl",
"moduleKey"
],
"properties": {
"repoUrl": {
"type": "string",
"minLength": 1,
"description": "GitHub repository URL or owner/repo. A private repo needs a githubToken."
},
"moduleKey": {
"type": "string",
"minLength": 1,
"description": "The module's key, e.g. 'secret-scan', 'dependency-cve', 'security', 'privacy', 'gdpr'."
},
"githubToken": {
"type": "string",
"description": "Optional read-only GitHub token. Without one, only public repos are reachable."
},
"authorization": {
"type": "string",
"description": "HUMAN CONFIRMATION. The `authorization` id from the confirm-link answer, once the account owner has pressed Confirm. Single-use, short TTL."
},
"confirmedCost": {
"type": "object",
"required": [
"kind",
"credits"
],
"properties": {
"kind": {
"type": "string",
"description": "The `kind` from the quoted cost, e.g. 'credits'."
},
"credits": {
"type": "number",
"description": "The `credits` number from the quoted cost."
},
"centicredits": {
"type": "number",
"description": "The `centicredits` integer from the quoted cost, if it carried one."
}
},
"description": "COST CONFIRMATION. Omit on the first call; then send back the exact quoted `cost`."
}
}
}Free nittim look: committed secrets and known CVEs over posted source files. No account, no key, no nittim credits. Hard evidence only: never scores, never a production verdict. Send SOURCE files, not build output (no node_modules, no dist, no binaries).
| Argument | Type | Description |
|---|---|---|
| name* | string | A display label for this project, e.g. 'my-abacus-app'. Sanitized before use. |
| files* | array | Source files as { path, content }[] — not build output. At most 1000; over the internal per-audit cap, the highest-priority ones win. |
| uploadGrant | string | Optional: the id of an upload approval the account owner already confirmed. A large post without one is answered with a confirmation covering the files and the price. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"name",
"files"
],
"properties": {
"name": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "A display label for this project, e.g. 'my-abacus-app'. Sanitized before use."
},
"files": {
"type": "array",
"items": {
"type": "object",
"required": [
"path",
"content"
],
"properties": {
"path": {
"type": "string",
"minLength": 1,
"description": "Relative path, e.g. 'src/index.ts'. No absolute paths, no '..', no backslashes."
},
"content": {
"type": "string",
"description": "The file's full text."
},
"encoding": {
"type": "string",
"description": "Omit or 'utf8' for text files. Any other value (e.g. 'base64') is rejected — text only in v1."
}
}
},
"maxItems": 1000,
"minItems": 1,
"description": "Source files as { path, content }[] — not build output. At most 1000; over the internal per-audit cap, the highest-priority ones win."
},
"uploadGrant": {
"type": "string",
"description": "Optional: the id of an upload approval the account owner already confirmed. A large post without one is answered with a confirmation covering the files and the price."
}
}
}NEEDS A KEY: mint one at https://nittim.com/keys. Re-checks ONE finding from a finished audit against the repository's current code, or a commit named in the call, and answers fixed, still present, or undetermined — with the reason. It reads only the file that finding cites. Free, capped per day, and it moves no score or verdict: the report keeps recording what was true of the commit it ran on.
| Argument | Type | Description |
|---|---|---|
| ref | string | A commit SHA or branch to check instead of the repository's current HEAD. Must be the audited commit or newer. |
| auditId* | string | The audit UUID, from its report link. |
| findingKey* | string | The finding's stable key, as printed beside it in the report's findings list. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"auditId",
"findingKey"
],
"properties": {
"ref": {
"type": "string",
"description": "A commit SHA or branch to check instead of the repository's current HEAD. Must be the audited commit or newer."
},
"auditId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"description": "The audit UUID, from its report link."
},
"findingKey": {
"type": "string",
"minLength": 1,
"description": "The finding's stable key, as printed beside it in the report's findings list."
}
}
}| HUMAN CONFIRMATION. The `authorization` id from the confirm-link answer, once the account owner has pressed Confirm. Single-use, short TTL. |
| confirmedCost | object | COST CONFIRMATION. Omit on the first call; then send back the exact quoted `cost`. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"name",
"files"
],
"properties": {
"name": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "A display label for this project, e.g. 'my-abacus-app'. Sanitized before use."
},
"files": {
"type": "array",
"items": {
"type": "object",
"required": [
"path",
"content"
],
"properties": {
"path": {
"type": "string",
"minLength": 1,
"description": "Relative path, e.g. 'src/index.ts'. No absolute paths, no '..', no backslashes."
},
"content": {
"type": "string",
"description": "The file's full text."
},
"encoding": {
"type": "string",
"description": "Omit or 'utf8' for text files. Any other value (e.g. 'base64') is rejected — text only in v1."
}
}
},
"maxItems": 1000,
"minItems": 1,
"description": "Source files as { path, content }[] — not build output. At most 1000; over the internal per-audit cap, the highest-priority ones win."
},
"fullScan": {
"type": "boolean",
"description": "True buys the wider Full Audit tier over the files you post, priced by pass count."
},
"uploadGrant": {
"type": "string",
"description": "Optional: the id of an upload approval the account owner already confirmed. A large post without one is answered with a confirmation covering the files and the price."
},
"authorization": {
"type": "string",
"description": "HUMAN CONFIRMATION. The `authorization` id from the confirm-link answer, once the account owner has pressed Confirm. Single-use, short TTL."
},
"confirmedCost": {
"type": "object",
"required": [
"kind",
"credits"
],
"properties": {
"kind": {
"type": "string",
"description": "The `kind` from the quoted cost, e.g. 'credits'."
},
"credits": {
"type": "number",
"description": "The `credits` number from the quoted cost."
},
"centicredits": {
"type": "number",
"description": "The `centicredits` integer from the quoted cost, if it carried one."
}
},
"description": "COST CONFIRMATION. Omit on the first call; then send back the exact quoted `cost`."
}
}
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"content"
],
"properties": {
"content": {
"type": "string",
"maxLength": 100000,
"minLength": 1,
"description": "The text to judge — code, a document, another model's output. Up to ~100KB."
},
"context": {
"type": "string",
"description": "Optional — background the judge should know, e.g. what this content is for."
},
"criteria": {
"type": "string",
"description": "Optional — what to judge it against, e.g. 'correctness and security'."
},
"authorization": {
"type": "string",
"description": "HUMAN CONFIRMATION. The `authorization` id from the confirm-link answer, once the account owner has pressed Confirm. Single-use, short TTL."
},
"confirmedCost": {
"type": "object",
"required": [
"kind",
"credits"
],
"properties": {
"kind": {
"type": "string",
"description": "The `kind` from the quoted cost, e.g. 'credits'."
},
"credits": {
"type": "number",
"description": "The `credits` number from the quoted cost."
},
"centicredits": {
"type": "number",
"description": "The `centicredits` integer from the quoted cost, if it carried one."
}
},
"description": "COST CONFIRMATION. Omit on the first call; then send back the exact quoted `cost`."
},
"modelUnderTest": {
"enum": [
"anthropic",
"openai",
"unspecified"
],
"type": "string",
"description": "Optional — which vendor family produced `content`, if it is itself a model's output. The judge that runs is always a different family than this names. Use 'unspecified' for anything that is not model output, or when the family is unknown."
}
}
}| Optional: 'converged' (two consecutive clean passes) or 'cap_reached' (stopped for any other reason). Omit if unsure — the read from `passes` is derived either way. |
| client_version | string | Your own version string, if you have one. |
| repo_size_bucket* | string | A rough size bucket for the repo you looped over. |
| first_wave_lenses | integer | Optional, with mode 'one_shot' only: how many lenses ran in parallel on pass 1. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"repo_hash",
"repo_size_bucket",
"passes"
],
"properties": {
"mode": {
"enum": [
"one_shot",
"serial"
],
"type": "string",
"description": "Optional: 'one_shot' (every lens sweeps the whole tree first, then one fix wave, then a short convergence loop) or 'serial' (one lens or area per pass, fixing between passes)."
},
"swept": {
"type": "boolean",
"description": "Optional: was the CLASS swept — a guard, lint rule or exhaustiveness check that makes a new instance loud — rather than only the instances a pass named? Never derived, never changes the reward. On a repeat report, omitting it keeps the last answer; `false` withdraws it."
},
"passes": {
"type": "array",
"items": {
"type": "object",
"required": [
"n",
"fixed",
"clean"
],
"properties": {
"n": {
"type": "integer",
"maximum": 9007199254740991,
"description": "This pass's number, starting at 1.",
"exclusiveMinimum": 0
},
"clean": {
"type": "boolean",
"description": "True iff this pass found nothing new."
},
"fixed": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "How many findings this pass fixed."
},
"findings": {
"type": "array",
"items": {
"type": "object",
"required": [
"category"
],
"properties": {
"low": {
"type": "integer",
"default": 0,
"maximum": 9007199254740991,
"minimum": 0
},
"high": {
"type": "integer",
"default": 0,
"maximum": 9007199254740991,
"minimum": 0
},
"medium": {
"type": "integer",
"default": 0,
"maximum": 9007199254740991,
"minimum": 0
},
"category": {
"enum": [
"security",
"privacy",
"reliability",
"code_quality",
"ai_risk",
"performance",
"devops",
"data",
"business",
"devex",
"accessibility",
"observability",
"maintainability"
],
"type": "string"
},
"critical": {
"type": "integer",
"default": 0,
"maximum": 9007199254740991,
"minimum": 0
}
},
"additionalProperties": false
},
"maxItems": 13,
"description": "Findings this pass named — one entry per category with something to report; omit a category that found nothing. Each count defaults to 0 when omitted."
}
},
"additionalProperties": false
},
"maxItems": 100,
"minItems": 1,
"description": "One entry per pass you actually ran, in order."
},
"repo_hash": {
"type": "string",
"pattern": "^[0-9a-f]{64}$",
"description": "sha256 of the repository's canonical identity (the lowercased 'owner/repo', or a stable local fingerprint) — never the repo name itself. nittim never sees the name."
},
"client_name": {
"type": "string",
"maxLength": 64,
"description": "Your own name — omit to read it from the MCP connection instead."
},
"convergence": {
"enum": [
"converged",
"cap_reached"
],
"type": "string",
"description": "Optional: 'converged' (two consecutive clean passes) or 'cap_reached' (stopped for any other reason). Omit if unsure — the read from `passes` is derived either way."
},
"client_version": {
"type": "string",
"maxLength": 64,
"description": "Your own version string, if you have one."
},
"repo_size_bucket": {
"enum": [
"xs",
"s",
"m",
"l",
"xl"
],
"type": "string",
"description": "A rough size bucket for the repo you looped over."
},
"first_wave_lenses": {
"type": "integer",
"maximum": 100,
"description": "Optional, with mode 'one_shot' only: how many lenses ran in parallel on pass 1.",
"exclusiveMinimum": 0
}
}
}