Tools

MCP tools reference for OpenContext.

save_context

Saves markdown content to .opencontext/<topic>.md. Existing files are overwritten.

Arguments

NameTypeRequiredDescription
topicstringyesLowercase snake_case or kebab-case topic name
contentstringyesMarkdown content to save

Example

user input
Save our API conventions under topic api-contracts.

read_context

Reads one saved topic, or lists all topics when no topic is provided.

Arguments

NameTypeRequiredDescription
topicstringnoTopic to read. Omit to list all saved topics.

Example

user input
Read the architecture context before changing the routing layer.

Version Control

You can commit .opencontext/ when it contains team-wide knowledge:

terminal
git add .opencontext

Or ignore it when context should stay local:

.gitignore
.opencontext/