Skip to main content
Glama
FedgeNo

conventions-mcp

by FedgeNo

Capture Convention or Instruction

capture_thought

Save coding conventions, instructions, corrections, or preferences for future reference. Each capture is classified by type, scope, and topics for easy retrieval.

Instructions

Save a coding convention, standing instruction, correction, or workflow preference for future reference — e.g. style rules ('always use 2-space indent'), standing directives ('never force-push to main'), a correction after getting something wrong, or a stated preference for how work should be done. Call this whenever the user states a rule or preference for how you should work, corrects your approach, or explicitly asks you to remember something — don't wait to be asked to 'save' it. Occasional non-coding notes are fine too, but this store is primarily for conventions and instructions that should carry across future sessions and projects. Classify it yourself using the type/scope/topics/projectSpecific fields below, based on the conversation the thought came from. If a single message states multiple distinct rules, call this once per rule — don't merge them into one capture — and relay each one individually the same as a single capture, not summarized together. After every successful call, state the captured content verbatim and its scope back to the user (the response text already contains both) — this is how they catch a misinterpreted rule and correct or delete it immediately, rather than discovering it wrong much later.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
typeYesClassify using the conversation this thought came from: 'convention' — a specific coding style/pattern rule; 'instruction' — a standing directive on how to work/behave; 'correction' — a past mistake and the corrected approach; 'preference' — a softer preference, not a hard rule; 'other' — anything else that still belongs in this store.
scopeYesThe language, framework, or general topic this applies to (e.g. 'PHP', 'SQL', 'git') — or 'global' if it isn't tied to a particular language/framework.
topicsYes1-3 short topic tags (e.g. 'git', 'testing', 'naming').
contentYesThe convention, instruction, or thought to capture — a clear, standalone statement that will make sense when retrieved later, in a different session, with no other context
projectSpecificYesTrue ONLY if this explicitly names one project/codebase or is obviously about its specific files/architecture — false (the default assumption) for anything that could apply across projects.
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Without annotations, description carries full burden. It explains the store persists across sessions and is primarily for conventions. It also instructs agent to echo captured content back. However, it does not disclose potential side effects (e.g., overwrites or appends, storage limits, error handling).

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness3/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Description is moderately concise; it front-loads purpose and usage but contains some redundancy (e.g., multiple examples of conventions). Could be trimmed without losing critical guidance. Still, every sentence serves a purpose.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given 5 required parameters and no output schema, description covers purpose, usage, parameter classification, and post-call behavior. However, it lacks details on error conditions, duplicate handling, and storage limits, which would be needed for full completeness.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema covers all 5 parameters with descriptions, so baseline is 3. Description adds value by advising on classification based on conversation and emphasizing that content must be a clear, standalone statement. This goes beyond schema to guide agent on proper use.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

Description clearly states the tool saves coding conventions, instructions, corrections, and preferences for future reference. It provides specific examples and distinguishes itself from siblings (delete_thought, search_thoughts, thought_stats) by focusing on capture.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Explicit guidance on when to call: 'whenever the user states a rule or preference...' and what not to do: 'don't wait to be asked to save it.' Also covers handling multiple rules: call once per rule. Distinguishes primary use from occasional non-coding notes.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Install Server

Other Tools

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/FedgeNo/conventions-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server