What is mattermost-mcp AGENTS.md?

A repository instruction file that tells coding agents how a Mattermost MCP project is organised, tested, linted, and run. Mattermost is a team-chat system, and MCP is a way for an agent to use connected tools.

Use it when working on this Python Mattermost MCP server, especially to run tests, pre-commit checks, or the server itself.

It gives an agent the project context and commands it needs before changing or checking the code.

mattermost-mcp AGENTS.md — Instructions file for Codex and OpenCode by Knuckles-Team: A repository instruction file that tells coding agents

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods

npx agentmods add instructions/knuckles-team/mattermost-mcp/agents-md

Clone the repo

git clone --depth 1 https://github.com/Knuckles-Team/mattermost-mcp

Made for: Codex, OpenCode.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

README.md

[![agentmods](https://agentmods.dev/badge/instructions/knuckles-team/mattermost-mcp/agents-md.svg)](https://agentmods.dev/instructions/knuckles-team/mattermost-mcp/agents-md)

Your own site

<a href="https://agentmods.dev/instructions/knuckles-team/mattermost-mcp/agents-md"><img src="https://agentmods.dev/badge/instructions/knuckles-team/mattermost-mcp/agents-md.svg" alt="Measured on agentmods" height="20"></a>

Per session 3,410 This file is loaded in full into every session.

When invoked 3,410 The same file — it is already loaded in full.

Security scan A 0 findings. Scan, not verified.

Origin 86% copy Near-identical to another mod in the catalogue.

Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

Model	Per session	Once invoked
Fable 5	$0.03410	$0.03410
Opus 5	$0.01705	$0.01705
Sonnet 5	$0.00682	$0.00682
Haiku 4.5	$0.00341	$0.00341

Measured 4d ago against content hash 18ce20287a99, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

mattermost-mcp AGENTS.md scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 4d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

Origin

This is a copy

86% identical to servicenow-api AGENTS.md — 194 lines differ, which has more behind it and is treated as the original. This page carries a canonical link to it rather than competing with it.

AGENTS.md · 277 lines

How it starts

The opening of the file, as written. The whole thing — 277 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Mattermost MCP Agent Specs

Claude Code loads this file via CLAUDE.md (@AGENTS.md import) — the two stay in sync. Edit this file, not CLAUDE.md.

This file acts as a machine-readable README for AI coding agents collaborating on this repository.

Tech Stack & Architecture

Language: Python >= 3.10
Ecosystem: agent-utilities Dynamic Facade
MCP Server: FastMCP (stdio and HTTP support)
Key Files:
- mattermost_mcp/mcp_server.py: FastMCP entry points and tool registration.
- mattermost_mcp/api_client.py: API facade inheriting from custom domain modules.
- mattermost_mcp/auth.py: Credentials loading, credential validation, and authentication headers.

Commands

Quality & Linting

Run pre-commit hooks locally:

pre-commit run --all-files

Execution & Run

Launch the FastMCP server in stdio mode:

python -m mattermost_mcp.mcp_server

Testing Suite

Execute the entire test suite:

pytest -v

Project Structure

File Tree

.
├── .bumpversion.cfg
├── .gitignore
├── .pre-commit-config.yaml
├── AGENTS.md
├── CHANGELOG.md
├── LICENSE
├── README.md
├── pyproject.toml
├── requirements.txt
├── docs
│   ├── concepts.md
│   ├── index.md
│   └── overview.md
├── docker
│   └── compose.yml
├── prompts
│   └── main_agent.md
├── tests
│   ├── conftest.py
│   ├── test_api_client.py
│   ├── test_concept_parity.py
│   ├── test_init_dynamics.py
│   ├── test_mcp_server.py
│   └── test_startup.py
└── mattermost_mcp
    ├── __init__.py
    ├── agent_server.py
    ├── api
    │   ├── api_client_base.py
    │   └── api_client_core.py
    ├── api_client.py
    ├── auth.py
    ├── mcp
    │   └── mcp_core.py
    └── mcp_server.py

Concept Registry

Concept ID	Name	Description
`CONCEPT:MM-OS.governance.mm`	Core API Client Operations	Dynamic API facade client integration
`CONCEPT:MM-OS.governance.mm-2`	FastMCP Tools Execution	FastMCP tool registration and stdio handling
`CONCEPT:MM-OS.identity.mm`	Identity & Gateway Security	Credential validation and SSL verification
`CONCEPT:AU-ECO.messaging.native-backend-abstraction`	Ecosystem Compliance	Multi-package integration compliance standard

Read the full file on GitHub · 277 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

4d ago First seen · 277 lines · 3,410 tokens per session scan A 18ce20287a99

Subscribe to this mod's changes

mattermost-mcp AGENTS.md is an instructions file published in the GitHub repository Knuckles-Team/mattermost-mcp (0 stars, last pushed 7d ago), licensed MIT. It adds 3,410 tokens to every session, about $0.0170 per session on Opus 5. A static security scan graded it A with 0 findings. It is 86% identical to servicenow-api AGENTS.md, differing in 194 lines, and is treated as a copy.

next.js AGENTS.md

AGENTS.md instructions for vercel/next.js, covering next.js development guide, codebase structure, monorepo overview, core package: packages/next and other important packages.

vercel/next.js · 7,296 tokens

codex AGENTS.md

AGENTS.md instructions for openai/codex, covering rust/codex-rs, the codex-core crate, code review rules, crate api surface and model visible context.

openai/codex · 5,182 tokens

vscode buildNext.instructions.md

Working notes and architecture documentation for the new esbuild-based build system in build/next. Use when making changes to the new build pipeline (transpile/bundle commands, NLS plugin, source-map handling, resource copying, or self-hosting watch tasks).

microsoft/vscode · 6,785 tokens

mattermost-mcp AGENTS.md