MCP Workflows
Common workflows you can run from Claude Code, Cursor, or any MCP client.
Overview
With MCP, your IDE's agent reads Cygent state with the atomic tools and drives everything else through cygent_chat — in plain English. You describe the intent; the agent picks the tools and sequences them.
Just describe what you want. You don't call tools manually — and the things that change state (audits, reviews, triage, finding updates) all go through cygent_chat, gated by your key's scope.
Review and fix findings
See what was found
cygent_findings — review findings, filtered by severity.
Inspect a finding
cygent_finding_detail — get the root cause, affected code, and the authoritative recommendation.
Apply a fix
Your IDE makes the fix locally using the finding context.
Sanity-check before committing
Ask cygent_chat "is this safe?" for a quick inline review, or call cygent_check_code directly for a deeper CARA analysis — it returns a job_id you poll with cygent_job_status.
Mark it resolved
Tell cygent_chat: "mark issue_4 as fixed." (Requires a mutate-scope key.)
Triage false positives
List and inspect
cygent_findings then cygent_finding_detail for each one you want to assess.
Dismiss with a reason
Tell cygent_chat: "issue_7 is a false positive — the reentrancy path is unreachable because X." It records the dismissal. (Requires mutate.)
Kick off an audit and wait
Pick the project
cygent_list_projects — confirm the exact owner-repo name.
Trigger the audit
Tell cygent_chat: "audit owner-repo." It returns a job_id immediately. (Requires operate.)
Poll to completion
cygent_job_status with the job_id until it's terminal.
Read the results
cygent_findings — the new findings are ready to review.
File a finding you spotted manually
Describe it to the agent
Tell cygent_chat: "triage and file this finding on owner-repo: …" with the details. (Requires mutate.)
Let triage validate it
Finding creation routes through the engine-validated triage job — cygent_chat returns a job_id.
Confirm the outcome
Poll cygent_job_status; the finding appears in cygent_findings once triage accepts it (or is rejected with a reason).