aoci-code MCP Server: Setup for Claude Code, Cursor and Codex

• Loads the working rules the agent follows for this project

  Hands the agent the project rules for how to read and update the index. The agent calls it when it has no reliable copy of the rules, and it is not meant to repeat within one session.

  Try: “Confirm the AOCI server is connected and load its rules.”

  Write · aoci_rules

• Gives the agent the whole map of your codebase in one read

  Sends the full index of your project to the agent, in chunks when it is large, then asks the agent to confirm it received all of it. This is the call that gives the agent a picture of the system before it starts a task.

  Try: “Load the AOCI overview for this repo, then explain how billing is structured.”

  Write · aoci_overview

• Pulls up specific index entries for named files or folders

  Fetches the index entries for particular files, folders or database tables. It is meant for filling a gap after the overview, not for replacing it.

  Try: “Show me the AOCI entries for the internal/auth folder.”

  Write · aoci_get_entries

• Searches the index by keyword or tag

  Looks through the index entries for a keyword or tag and returns the matches. The agent uses it when it does not yet know which file it needs.

  Try: “Search the AOCI index for entries about retry logic.”

  Write · aoci_search

• Reads the tag dictionary and entry-writing rules

  Returns the vocabulary the index uses, such as the tag dictionary and example entries. The agent checks it when it is unsure how an entry should be written.

  Try: “Show me the tag dictionary AOCI uses for this project.”

  Write · aoci_header

• Finds index entries that are out of date after code changes

  Compares the index with the current code and returns the next batch of entries that are missing, stale or orphaned, for the agent to write. It also records receipts and a local audit entry, and it can advance the baseline for pure formatting changes.

  Try: “I have finished this change and the tests pass. Bring the AOCI index back in line.”

  Write · aoci_maintain

• Writes the agent's new or revised entries into the index

  Saves a full batch of entries the agent wrote for the changed files. It checks them against the source and the tag rules first, then writes the index files and baseline in one step, or rejects the batch.

  Try: “Write the AOCI entries for the files I just changed.”

  Write · aoci_update_entry

• Deletes an index entry whose file or table no longer exists

  Removes one index entry when the file or database table it described is gone. It does not delete any source file, database object or saved evidence, and it refuses entries that are not orphaned.

  Try: “Remove the AOCI entry for the file I deleted, if it is flagged as an orphan.”

  Delete · aoci_remove_entry

• Records a follow-up note when the agent lacks enough evidence

  Saves a note about work that needs a person or more evidence, plus an audit record, without touching the index. The agent uses it instead of guessing an entry it cannot support.

  Try: “Log a follow-up that the payments module needs a human to confirm its purpose.”

  Write · aoci_report

Watch out for

• It writes index files into your repository

  init adds aoci.txt, aoci.meta.txt, aoci.code.txt, AGENTS.md and a .aoci folder, and the agent updates them as it works. Review them in Git like any other change. github.com

• It can delete index entries

  The remove tool deletes an index entry only when its file or table is gone, and it removes no source file or database object. Check what the agent removes before you commit. github.com

• Tool text tells the agent not to ask you

  The overview tool tells the agent to fetch every chunk automatically and not to ask the user or give a partial answer. Keep that in mind if you want to approve each step. github.com

• Release candidate, source-available license

  The current release is v0.1.0-rc23 under FSL-1.1-MIT, which bars using it in a competing product or service. Follow the project's signature checks before you run the downloaded binary. github.com

• Database indexing reads schema only

  It runs only when you declare a database and run an explicit command, reads table structure and not rows, and runs no DDL or DML. The README names PostgreSQL, MySQL and openGauss. github.com

• Optional AI endpoint makes network calls

  AI is off by default. If you set up your own endpoint, ai test and doctor --net send real network requests to it. github.com

Security advisories