MCP tools

Tracemoor gives the AI its index, projectdocs, specs and Git functions as tools of the MCP server code-explorer. In the chat transcript, a tool call appears with the prefix mcp__code-explorer__, for example mcp__code-explorer__describe_symbol. See Working with the AI.

A tool marked Brave changes state. It runs only in a session in Brave mode. In Read-Only and Safe mode it answers that the session needs Brave mode. See Session modes. Several of these tools show a preview that you confirm before anything is written.

Reference projects have their own servers ce-ref-<slug> with a read-only subset of these tools. See Reference projects and the AI.

Index and status

ToolBravePurpose
statusFreshness of the index and counts of files, symbols and languages.
reanalyze_projectStarts a new analysis of the project.
sweep_statusState of a baseline sweep.

Symbols and text

ToolBravePurpose
describe_symbolDefinition, direct callers and callees of a symbol.
code_searchFull-text search over the source files.
text_searchSearch for user-facing strings, including i18n values.
find_ui_sourceFrom a visible UI label to the code that renders it and its event handler.
find_labelRanked search over UI labels.
ui_elementsStructured UI elements: tag, label, handler, component.
find_similarSymbols whose meaning is close to a description.
find_duplicatesPairs of symbols with near-identical meaning.
semantic_domainsGroups the code into functional domains.
symbol_testsTests that cover a symbol.

Graph

ToolBravePurpose
neighborsDirect neighbours of a file or symbol, up to three hops.
call_chainAll callers and callees of a symbol with code snippets.
call_treeCallers and callees of a symbol as one tree.
transitive_callersCallers of a symbol over several levels.
transitive_calleesCallees of a symbol over several levels.
shortest_pathShortest import path between two files.
file_importsFiles a file imports.
file_importersFiles that import a file.
impact_radiusFiles that depend on a file, directly or indirectly.
dependencies_radiusFiles a file depends on, directly or indirectly.
metricsLines, fan-in, fan-out and instability per file.
findingsCycles, dead exports and orphan files.
cluster_treeCluster hierarchy with labels and sizes.
cluster_filesFiles of one cluster.

Interfaces and reference projects

ToolBravePurpose
boundary_listEndpoints, messages, commands and IPC calls the project provides or uses.
xref_linksLinks between calls here and endpoints in linked references.
xref_unresolvedCalls here that no linked reference answers.
xref_call_treeCall tree that continues into linked references.
xref_compareDifferences between two states of a linked reference, and calls that break.

projectdocs

ToolBravePurpose
projectdocs_list_phasesPhases with status and parent.
projectdocs_read_entryOne entry.
projectdocs_search_docsKeyword search over entries.
projectdocs_semantic_searchSearch by meaning over entries, optionally over specs.
projectdocs_for_symbolEntries anchored to a symbol.
symbols_for_projectdocSymbols anchored from an entry, with current location.
projectdocs_create_phaseyesCreates a phase or subphase.
projectdocs_rename_phaseyesChanges the title of a phase.
projectdocs_set_phase_parentyesMoves a phase under another phase.
projectdocs_set_phase_statusyesSets the status of a phase.
projectdocs_mark_phase_reviewedyesStamps the review time of a phase.
projectdocs_create_entryyesCreates an entry.
projectdocs_append_entry_sectionyesAppends a section to an entry.
projectdocs_set_entry_statusyesSets the status of a bugreport.
projectdocs_set_entry_tagsyesReplaces the tags of an entry.
projectdocs_append_commentyesAdds a comment block.
projectdocs_toggle_commentyesMarks a comment as resolved or new.
projectdocs_anchor_addyesAnchors an entry to a symbol.
projectdocs_anchor_removeyesRemoves a symbol anchor.
projectdocs_sync_anchorsyesWrites anchors that exist only in the index into the entries, then rebuilds the index from the entries.
projectdocs_commit_anchor_addyesAnchors an entry to a commit.
projectdocs_commit_anchor_removeyesRemoves a commit anchor.
projectdocs_verify_commit_anchorsChecks all commit anchors against the repository.
projectdocs_remap_commit_anchorsyesRepairs commit anchors after a history rewrite.
session_new_chat_from_entryyesStarts a new chat session with an entry or text as first message.

Documents in the Docs View

ToolBravePurpose
docs_listMarkdown documents of the exploration outside projectdocs and specs.
docs_searchFinds documents by name or content.
docs_readReads a document.
docs_createyesCreates a document.
docs_writeyesReplaces the content of a document.
docs_append_sectionyesAppends a section.
docs_renameyesRenames a document.
docs_moveyesMoves a document to another folder.
docs_deleteyesDeletes a document.

Specs

ToolBravePurpose
spec_profile_activeActive spec profile with types, links and workflow.
spec_listLists spec artifacts.
spec_readReads an artifact.
spec_searchFull-text search over artifacts.
spec_templateTemplate for an artifact type.
spec_createyesCreates an artifact.
spec_update_bodyyesReplaces the body of an artifact.
spec_set_fieldyesSets one frontmatter field.
spec_set_statusyesMoves an artifact to another status. An approval needs a signer when the profile requires signatures.
spec_batch_set_statusyesMoves several artifacts with one signature.
spec_request_batch_approvalyesPrepares a batch approval for a person to sign.
spec_list_approval_requestsBatch approvals waiting for a signature.
spec_add_linkyesLinks two artifacts.
spec_remove_linkyesRemoves a link.
spec_add_anchoryesAnchors an artifact to a symbol.
spec_add_anchors_batchyesAdds many anchors in one pass.
spec_remove_anchoryesRemoves an anchor.
spec_reanchoryesMoves an anchor to another symbol.
spec_anchors_for_symbolArtifacts anchored to a symbol.
spec_symbols_for_artifactAnchors of an artifact.
spec_suspect_anchorsAnchors marked suspect.
spec_resolve_suspectyesResolves a suspect anchor.
spec_resolve_all_anchorsResolves all anchors against the current index again.
spec_reindexRebuilds the spec index from the files.
reverse_spec_create_draftyesCreates a spec draft from code, with anchors.
reverse_spec_list_draftsDrafts of a run.
reverse_spec_accept_draftyesAccepts a draft.
reverse_spec_discard_draftyesDiscards a draft.
reverse_spec_run_startyesStarts a run that generates drafts for a list of symbols.
reverse_spec_run_statusState of a generation run.
spec_decompose_strategiesStrategies for capability decomposition.
spec_decompose_candidatesCapability candidates from the code graph.

Coverage, traceability and signatures

ToolBravePurpose
spec_coverage_summaryCoverage figures of the project.
spec_coverage_for_fileCoverage of a file.
spec_coverage_for_symbolCoverage of a symbol.
spec_coverage_for_clusterCoverage of a cluster.
spec_coverage_gapsCode without spec coverage.
spec_coverage_overlayData of the coverage heatmap.
spec_traceability_matrixLive traceability matrix.
spec_export_matrix_markdownTraceability matrix as a Markdown table.
spec_signing_statusSigner, credential and lockout state.
spec_set_signer_profileyesSets the local signer identity. Refused once a signing passphrase is set; then change the identity in Project Settings › Signing.
spec_register_signeryesRegisters the SSH public key in specs/_signers.yaml.
spec_verify_signatureChecks the signature of an artifact.
spec_verify_audit_chainChecks the audit trail.
audit_bundle_createyesCreates an audit bundle.
audit_bundle_listLists audit bundles.
audit_bundle_openPath of a bundle file.
audit_bundle_verifyChecks a bundle.

Git, changelists and sharing

ToolBravePurpose
changelists_listChangelists of the exploration.
changelists_createyesCreates a changelist.
changelists_set_activeyesMakes a changelist active.
exploration_statusGit state of the exploration.
exploration_commityesCommits the exploration.
exploration_pullyesPulls the exploration from its remote.
exploration_pushyesPushes the exploration.
exploration_set_remoteyesSets the remote of the exploration.
pr_listPull requests of the repository.
pr_getOne pull request.
pr_review_commentsReview comments of a pull request, as threads.
pr_reply_commentyesReplies to a review comment.

Tickets and work packages

ToolBravePurpose
tickets_providersConfigured ticket providers and their state.
tickets_searchSearches tickets.
tickets_getOne ticket.
tickets_childrenTickets under a parent.
tickets_templatesTicket templates of the project.
tickets_create_metaProjects, types and fields for a new ticket.
tickets_edit_metaEditable fields of a ticket.
tickets_transitionsAllowed status transitions of a ticket.
tickets_createyesCreates a ticket.
tickets_updateyesChanges title, description or fields.
tickets_commentyesAdds a comment.
tickets_assignyesAssigns or unassigns a ticket.
tickets_transitionyesMoves a ticket to another status.
tickets_set_parentyesMoves tickets under a parent.
tickets_import_to_projectdocsyesImports tickets as projectdocs entries.
workflow_policy_getReads the Workflow Policy.
workflow_policy_setyesCreates or changes the Workflow Policy.
workpackage_statusState of all open work packages.
workpackage_startyesStarts a work package branch.
workpackage_switchyesChecks out another branch.
workpackage_syncyesMerges the base branch into a package.
workpackage_open_pryesOpens the pull request of a package.
workpackage_finishyesFinishes a merged package.

Run configuration

ToolBravePurpose
run_config_readReads run.toml or build.toml.
run_config_writeyesWrites run.toml or build.toml.

Operating an application (macOS)

ToolBravePurpose
app_windowsWindows of running applications.
app_screenshotPicture of one window.
app_elementsControls of a window from the accessibility interface.
app_pressyesPresses a control by its path.
app_menuyesChooses a menu entry.
app_clickyesClicks at a point in a window.
app_typeyesTypes text.
app_keyyesPresses a key, with modifiers.
app_scrollyesScrolls.
app_dragyesDrags from one point to another.