mcp-coda: Instructions file for Codex

AGENTS.md

mcp-coda AGENTS.md is an instructions file for Codex, OpenCode from vish288/mcp-coda. It costs 4,662 tokens per session, scanned A, original, MIT.

A project guide for mcp-coda, a server that connects coding agents to Coda, a document and database service, through its API.

In plain words
What is it for?
Use it when changing tools for Coda documents, pages, tables, rows, formulas, permissions, publishing, automations, or analytics.
Why use it?
It gives an agent the project’s architecture, permission rules, implementation patterns, and testing expectations in one place.

Instructions file for CodexOpenCode

Written for Codex and OpenCode: the file is AGENTS.md. Also seen: mentions AGENTS.md.

This is vish288/mcp-coda's own configuration. It tells Codex and OpenCode how to work on mcp-coda itself, so it is not a mod to install elsewhere. Copy it as a starting point and replace the rules that are about this project. Everything mcp-coda configures →

Reuse

Borrowing it

Nothing to install: this file belongs to vish288/mcp-coda. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file
curl -O https://raw.githubusercontent.com/vish288/mcp-coda/main/AGENTS.md
Clone the repo
git clone --depth 1 https://github.com/vish288/mcp-coda

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.

agentmods badge for mcp-coda AGENTS.md

README.md
[![agentmods](https://agentmods.dev/badge/instructions/vish288/mcp-coda/agents-md/github.svg)](https://agentmods.dev/instructions/vish288/mcp-coda/agents-md)
Your own site
<a href="https://agentmods.dev/instructions/vish288/mcp-coda/agents-md"><img src="https://agentmods.dev/badge/instructions/vish288/mcp-coda/agents-md/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for mcp-coda AGENTS.md

Your own site · 80×15
<a href="https://agentmods.dev/instructions/vish288/mcp-coda/agents-md"><img src="https://agentmods.dev/badge/instructions/vish288/mcp-coda/agents-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 4,662 This file is loaded in full into every session.
When invoked 4,662 The same file — it is already loaded in full.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found 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.

ModelPer sessionOnce invoked
Fable 5.1 $0.04662 $0.04662
Opus 5.5 $0.01865 $0.01865
Sonnet 5.5 $0.00932 $0.00932
Haiku 4.5 $0.00466 $0.00466

Measured 7d ago against content hash ea42c7169fb3, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

mcp-coda 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 7d 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.

AGENTS.md · 207 lines

How it starts

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

mcp-coda — Agent Context

MCP server for the Coda v1 API. It provides 54 tools, 12 resources (2 live data + 5 rules + 5 guides), and 5 prompts. They cover docs, pages, tables, rows, formulas, controls, permissions, folders, publishing, automations, and analytics.

mcp-coda runs on FastMCP. PyPI hosts it as the mcp-coda package. Install it with uvx mcp-coda.

Protocol support

  • Implements the MCP 2026-07-28 specification (MCP 2.0). Stays compatible with 2025-11-25 clients.
  • Built on FastMCP 4.x and the MCP Python SDK 2.x.
  • Transports: stdio (default) and streamable-http (recommended for remote). sse still works, but the 2026-07-28 spec deprecates it, so the server prints a warning.
  • Uses tools, resources, and prompts only. No Roots, Sampling, Logging, elicitation, or resource subscriptions, so the 2026-07-28 deprecations do not affect it.

Layout

  • src/mcp_coda/__init__.py — click CLI, loads .env via python-dotenv, runs the FastMCP server
  • src/mcp_coda/servers/__init__.py — the FastMCP instance, lifespan (builds the shared CodaClient), and _register_tools() which imports every tool module so decorators execute
  • src/mcp_coda/servers/*.py — one module per domain (docs, pages, tables, rows, …)
  • src/mcp_coda/servers/_helpers.py — shared _get_client, _ok, _ok_markdown, _err, _check_write, _format_list_as_markdown
  • src/mcp_coda/servers/resources.py / prompts.py — MCP resources and prompts
  • src/mcp_coda/resources/ — static markdown backing the rules/guides resources
  • src/mcp_coda/client.py — async httpx client wrapping every Coda API call. Transport (R2): a per-phase httpx.Timeout with the connect phase capped at 10s and AsyncHTTPTransport(retries=2) for connection errors; a single _send path adds GET-only status retries (502/503/504 with jitter, 429 when Retry-After ≤ 5s, max 2 attempts, writes never retried) and splits a timeout (CodaTimeoutError) from an unreachable host (CodaConnectionError; a ConnectTimeout counts as unreachable). Worst-case latency against a hard-down host is roughly 2 × (3 × connect-cap + timeout) + jitter — the connect cap is 10s, the two outer attempts are the GET status-retry and each wraps httpx's three connect tries (retries=2)
  • src/mcp_coda/config.py — CodaConfig dataclass built from env vars; CODA_TIMEOUT is validated with a named error
  • src/mcp_coda/exceptions.py — CodaApiError, CodaNotFoundError, CodaRateLimitError, CodaTimeoutError, CodaConnectionError, …
  • tests/unit/ — ~307 tool- and unit-level tests; tests/conftest.py holds shared fixtures
  • tests/test_doc_parity.py — re-derives tool/resource/prompt counts, tool names and version strings from the source and asserts the docs match; tests/test_links.py checks external URLs
  • evaluations/eval.xml — question / expected-answer / expected-tool pairs used to sanity-check tool selection

Read the full file on GitHub · 207 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.

  1. 7d ago Changed · +267 tokens per session ea42c7169fb3
  2. 11d ago Changed · +10 lines · +397 tokens per session 030782217f98
  3. 14d ago Changed · -5 tokens per session d9e865d1d40e
  4. 15d ago Changed · +45 tokens per session 0da7635a3c38
  5. 16d ago Changed · +3 lines · +377 tokens per session b4e7622ee01c
  6. 18d ago Changed · +4 lines · +250 tokens per session a3ac8ebe8aec
  7. 19d ago Changed · +2 lines · +294 tokens per session 8af0cd923e80
  8. 26d ago Changed · +7 lines · +157 tokens per session 195fb836fd45
  9. 1mo ago Changed · -4 lines · -59 tokens per session 52fb5b0cae8e
  10. 1mo ago First seen · 185 lines · 2,939 tokens per session scan A 7b10d779aa77

Subscribe to this mod's changes

mcp-coda AGENTS.md is an instructions file published in the GitHub repository vish288/mcp-coda (2 stars, last pushed 5d ago), licensed MIT. It adds 4,662 tokens to every session, about $0.0186 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other instructions, from other repositories

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 · 9,715 tokens

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,461 tokens

vscode oss-third-party-notices.instructions.md

Instructions for microsoft/vscode, covering vs code oss third-party-notices pipeline, architecture, pipeline flow in ci, cache eligibility and rollout and applying the notice (cutover).

microsoft/vscode · 5,262 tokens

langchain AGENTS.md

AGENTS.md instructions for langchain-ai/langchain, covering global development guidelines for the langchain monorepo, corridor security analysis, project architecture and context, monorepo structure and development tools & commands.

langchain-ai/langchain · 4,680 tokens

vscode copilot-instructions.md

Copilot instructions for microsoft/vscode, covering vs code copilot instructions, project overview, root folders, core architecture (src/ folder) and built-in extensions (extensions/ folder).

microsoft/vscode · 2,750 tokens

deepseek-harness AGENTS.md

AGENTS.md instructions for deepseek-ai/deepseek-harness, covering agents.md, pre-stable apis and released session data, repository layout, commands and host sandbox failures.

deepseek-ai/deepseek-harness · 4,261 tokens