What is MCP AGENTS.md?

Repository instructions for GravityKit MCP, a Node.js server that lets AI agents work with Gravity Forms and some GravityKit products through the Model Context Protocol. Gravity Forms is a WordPress tool for building forms and managing submissions.

Use them when working on Gravity Forms tools, GravityView integrations, WordPress abilities, REST API coverage, or the MCP server itself.

They explain the server's two tool groups, supported APIs, project layout, and connection requirements before changes are made.

How GravityKit/MCP configures Codex and OpenCode

Reuse

Borrowing it

Nothing to install: this file belongs to GravityKit/MCP. 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/GravityKit/MCP/develop/AGENTS.md

Clone the repo

git clone --depth 1 https://github.com/GravityKit/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/gravitykit/mcp/agents-md/github.svg)](https://agentmods.dev/instructions/gravitykit/mcp/agents-md)

Your own site

<a href="https://agentmods.dev/instructions/gravitykit/mcp/agents-md"><img src="https://agentmods.dev/badge/instructions/gravitykit/mcp/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.

Your own site · 80×15

<a href="https://agentmods.dev/instructions/gravitykit/mcp/agents-md"><img src="https://agentmods.dev/badge/instructions/gravitykit/mcp/agents-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>

Per session 11,326 This file is loaded in full into every session.

When invoked 11,326 The same file — it is already loaded in full.

Security scan A 1 finding. 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.

Model	Per session	Once invoked
Fable 5.1	$0.11326	$0.11326
Opus 5.5	$0.04530	$0.04530
Sonnet 5.5	$0.02265	$0.02265
Haiku 4.5	$0.01133	$0.01133

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

Security

Grade A, and why

MCP AGENTS.md scanned grade A with 1 finding 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 23d 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.

Makes network callslowCapability

Not a fault in itself. Listed so you know the mod talks to something, and to what.

16. **The WP Abilities catalog is paginated and defaults to 50 per page.** `X-WP-Total` and `X-WP-TotalPages` carry the real count; page one looks like the whole catalog. `fetchFoundationEntries`/`fetchCoreEntries` in `s

AGENTS.md · 474 lines

How it starts

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

AGENTS.md — GravityKit MCP

MCP server for Gravity Forms (primary) and GravityKit products (secondary). It exposes 26 always-on Gravity Forms tools plus a dynamic set of GravityKit product tools generated from the connected site's Foundation Abilities catalog — GravityView is the only GravityKit product implemented so far.

This is the single canonical doc for the project (agents and humans). CLAUDE.md simply re-exports it via @AGENTS.md.

Project Identity

Package: @gravitykit/mcp v2.6.1
Type: Node.js MCP server (ESM)
Purpose: Full Gravity Forms REST API v2 coverage (26 Gravity Forms tools), plus dynamic GravityKit product tools (GravityView so far) via the WordPress Abilities API
Repo: https://github.com/GravityKit/MCP

Quick Start

What this is: A Node.js MCP (Model Context Protocol) server with two independent capability planes:

Plane A — Gravity Forms (gf_*), primary. 26 static tools wrapping the Gravity Forms REST API v2 (forms, entries, feeds, notifications, submissions, field filters, results, and intelligent field management). Always available when Gravity Forms REST credentials work — on any Gravity Forms site.
Plane B — GravityKit, secondary. Tools generated at runtime from the connected site's GravityKit Foundation Abilities catalog; each product registers tools under its own server-owned prefix. They appear only when Foundation is active. GravityView is the only product wired up so far, using the gv_* prefix (View authoring, fields, widgets, search, layouts). The plane is product-agnostic: any GravityKit product that registers Foundation abilities shows up automatically under its own prefix.

The two planes are independent: a GF-only site gets the full gf_* surface with no abilities; a GravityKit site without GF REST keys still gets its GravityKit tools.

Main entry point: src/index.js Architecture style: MCP SDK server with stdio transport, one HTTP client per plane, composable validation Key dependency: @modelcontextprotocol/sdk ^1.0.0

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

23d ago Changed dadd5631c875
1mo ago Changed · +8 lines · +672 tokens per session 3536e42de7da
1mo ago Changed · +10 lines · +1,801 tokens per session scan C → A 32466ec8ffc7
1mo ago Changed · +3 lines · +158 tokens per session 7ec8ee77ed5d
2mo ago First seen · 453 lines · 8,695 tokens per session scan C 403dc0f74794

Subscribe to this mod's changes

MCP AGENTS.md is an instructions file published in the GitHub repository GravityKit/MCP (24 stars, last pushed 6d ago), licensed MIT. It adds 11,326 tokens to every session, about $0.0453 per session on Opus 5.5. A static security scan graded it A with 1 finding (makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Gravity ai gravity-forms wordpress

MCP AGENTS.md next to 6 instructions from other repositories
Mod	Type	Stars	Last push	Licence	Scan	Tokens	Works with
MCP AGENTS.mdGravityKit/MCP	Instructions file	24	6d ago	MIT	A	11,326	Codex, OpenCode
vscode buildNext.instructions.mdmicrosoft/vscode	Instructions file	195k	yesterday	MIT	A	9,719	GitHub Copilot
next.js AGENTS.mdvercel/next.js	Instructions file	143k	yesterday	MIT	A	7,461	Codex, OpenCode
langchain AGENTS.mdlangchain-ai/langchain	Instructions file	149k	yesterday	MIT	A	4,680	Codex, OpenCode
vscode oss-third-party-notices.instructions.mdmicrosoft/vscode	Instructions file	195k	yesterday	MIT	A	5,516	GitHub Copilot
vscode copilot-instructions.mdmicrosoft/vscode	Instructions file	195k	yesterday	MIT	A	3,093	GitHub Copilot
deepseek-harness AGENTS.mddeepseek-ai/deepseek-harness	Instructions file	274k	2d ago	MIT	A	4,313	Codex, OpenCode

MCP: Instructions file for Codex