disputes_list
List disputes, newest first. Filter by status or party_type. Page with offset=<next_offset>.
limitoffsetstatusparty_type
io.github.seayniclabsPublished by GitHub account seayniclabsv0.2.2Updated Nov 3, 2026
Track credit-report disputes and draft dispute letters, kept on your computer. Not legal advice.
Local MCP server that lets an assistant track credit-report disputes, compute statutory response deadlines, and draft dispute letters as files on your computer.
Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.
Follow the launch instructions in the repository.
Made by Seaynic Labs. Need tools like this built around your own systems? We do that.
PrivacyOps lets an AI assistant track your credit-report disputes and draft dispute letters, with every record kept in a file on your own computer. It works out the statutory response deadline for each open dispute, and it ships skills that walk you through a dispute from gathering facts to following up.
Not legal advice. PrivacyOps is a tracking and drafting aid. It does not know your facts or the law in your state. The letter templates have not been reviewed by a lawyer. For legal questions, ask a lawyer or a consumer-protection agency.
It is a bundle: tools, skills and instructions in one install. The tools are one server made of modules. You switch on the modules you use. New modules arrive switched off, so an update never changes what your assistant can do until you choose to.
Planned, not built: data-broker opt-outs and credit-freeze tools. These are ideas, not commitments.
Audience: consumers who want their own record of disputes and clear letters. PrivacyOps is not for lawyers, credit repair businesses, or anyone handling other people's identity information.
Skills are short guides your assistant reads before it does a job. PrivacyOps ships two, in two forms from one source: a skills/ folder for apps that read Agent Skills (Claude Code and others), and MCP prompts for every other MCP app.
No third-party skills ship with PrivacyOps. See CREDITS.md.
~/.local/share/privacyops/privacyops.json. Set PRIVACYOPS_DATA_DIR to choose another folder.letters/ inside that folder.~/.local/state/privacyops/approvals.jsonl: ids and decisions only.0600), but they are not encrypted. Anyone with access to your account can read them. Keep the folder out of shared or synced folders you do not control.PrivacyOps never asks for a Social Security number. If a bureau asks for identifying numbers, you write them in by hand on the printed letter.
PrivacyOps needs Python 3.11 or newer. With uv you do not install anything ahead of time:
Pin the exact version if you want updates only when you choose them: uvx privacyops-mcp==0.2.2.
Or with pip:
As a Claude Code plugin (server and skills in one step, once the seayniclabs/plugins marketplace lists PrivacyOps):
Uninstalling with pip uninstall privacyops-mcp removes the program only. Your records and letters stay in the data folder. Delete that folder yourself if you want them gone.
PrivacyOps starts without any settings. The defaults are safe.
Config file (optional). PrivacyOps also reads ~/.config/privacyops/config.toml, or the file named by PRIVACYOPS_CONFIG. Environment variables win over the file.
Most clients use the same JSON shape. Put it where your client keeps MCP servers:
Over HTTP. For clients that connect to a URL instead of launching a process:
It serves streamable HTTP at http://127.0.0.1:8765/mcp and listens only on your own machine by default. Put authentication in front of it before exposing it anywhere else.
Paste one into your assistant once PrivacyOps is set up:
Every tool returns structured data with a published schema. Errors read privacyops.<module>.<code>: <message> Fix: <hint>.
disputes_deadlines counts the periods that the statute sets, from the sent date you record:
The tool counts from your sent date. The statute counts from the day the other side receives the dispute, so the real deadline is the same or later. The tool does not know when the letter arrived, whether you sent extra information, or which route a furnisher dispute took, so it says so in each row instead of guessing. The periods were checked against the official text on 2026-10-27.
Both templates are fixed text. Nothing is generated by a model. Each citation was checked against the official statute text on 2026-10-27.
Contact details are included only where the agency's own site was checked on 2026-10-27:
Check any address against the agency's own website before you mail a letter. Agencies change their addresses.
PRIVACYOPS_DISPUTES_ALLOW_DELETE=true.privacyops_modules, in every skill, and in every letter's footer.Doctor reads your data folder, records file, letter folder and approval log. It prints ok or FIX for each item, with the step to take, and exits 1 when something needs fixing. It makes no network calls and changes no files.
The tests use temporary data folders and make no network calls. scripts/tool_lock.py (without --check) rewrites the lock after a deliberate change to a tool, prompt or the instructions. Add a changelog line in the same change.
Report a vulnerability privately through GitHub (Security tab, "Report a vulnerability"). See SECURITY.md.
MIT. Published by Seaynic Labs.
Built by Seaynic Labs. We build tools like this around a business's own systems: local-first, with a person approving every change. See custom integrations.
Source: README.md at commit 6cff06d
List disputes, newest first. Filter by status or party_type. Page with offset=<next_offset>.
limitoffsetstatusparty_typeThe full record for one dispute: details, due date, letters written, and history.
idrequiredOpen disputes (draft, sent, response_received) with the statutory response deadline for each. An agency must reinvestigate within 30 days of receiving the dispute, 15 U.S.C. 1681i(a)(1)(A) (https://www.law.cornell.edu/uscode/text/15/1681i). A furnisher must report results before that period ends, 15 U.S.C. 1681s-2(a)(8)(E)(iii) and (b)(2) (https://www.law.cornell.edu/uscode/text/15/1681s-2). Counted from the sent date you recorded, so the real date is the same or later. Returns days remaining, an overdue flag (past the 30-day date), the next action, and the facts the tool cannot know (the start of the clock, the 15-day extension, a furnisher's extension). Not legal advice. Set as_of (YYYY-MM-DD) to check another day. Page with offset=<next_offset>.
as_oflimitoffsetStart tracking a dispute. party_type is consumer_reporting_agency or furnisher. Use the item's description, not full account numbers.
reasonstatussent_dateparty_namerequiredparty_typerequireditem_descriptionrequiredChange a dispute's status, set its sent date, or add a note. Every change is recorded in history. Setting status to sent without a sent date uses today's date.
idrequirednotestatussent_dateDelete a dispute record. Without confirm=true this only returns a preview. With confirm=true the person is asked to approve (unless deletes are pre-approved in settings). Letter files on disk are not deleted. The assistant cannot approve on the person's behalf.
idrequiredconfirmThe letter templates, the agencies with checked contact details, and the disclaimer. Read this before generating a letter.
Takes no parameters.
Write a dispute letter from a fixed template to a text file. Your name, address and signature are placeholders to fill in by hand. For a credit agency pass agency_key (equifax, experian, transunion) or recipient_name. Pass dispute_id to attach the letter to a dispute record. Not legal advice.
reasontemplaterequiredagency_keydispute_idrecipient_nameitem_descriptionrequiredrecipient_addressWhich modules are on, what each tool does, where your data is kept, the skills, and the disclaimer. Pass a module name for its full settings list.
module90% of the applicable checks met
How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.
Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.
uvx privacyops-mcp --versionuvx privacyops-mcp --doctor # checks your data folder and records, prints fixespip install privacyops-mcp/plugin marketplace add seayniclabs/plugins/plugin install privacyops@seayniclabsdata_dir = "/Users/you/Documents/privacyops"
[disputes]allow_delete = false
[letters]enabled = true{ "mcpServers": { "privacyops": { "command": "uvx", "args": ["privacyops-mcp"], "env": { "PRIVACYOPS_DATA_DIR": "/Users/you/Documents/privacyops" } } }}privacyops-mcp --transport http --port 8765uvx privacyops-mcp --doctoruv venv -p 3.11 && uv pip install -e '.[dev]'.venv/bin/pytestpython3 scripts/check_skills.py.venv/bin/python scripts/tool_lock.py --check.venv/bin/python scripts/security_card.py --check