You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: AGENTS.md
+5-5Lines changed: 5 additions & 5 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,4 +1,4 @@
1
-
# AGENTS.md — GravityMCP
1
+
# AGENTS.md — GravityKit MCP
2
2
3
3
> MCP server providing 28 tools for full Gravity Forms REST API v2 coverage, enabling AI agents to manage forms, entries, feeds, notifications, and fields programmatically.
@@ -336,7 +336,7 @@ No build step — pure ESM JavaScript, runs directly with `node src/index.js`. R
336
336
337
337
11.**`gf_list_field_types` defaults to summary mode.** Returns only `type`, `label`, `category` per field type. Pass `detail=true` for full metadata (supports, storage, validation). Pass `include_variants=true` with `detail=true` for variant data. This prevents accidentally dumping thousands of tokens for all 44 field types. — `field-operations/index.js:142-211`
338
338
339
-
12.**Test mode resolves env vars at client construction.** When `GRAVITYMCP_TEST_MODE=true`, `testConfig.resolveEnv()` remaps `GRAVITY_FORMS_TEST_BASE_URL` → `GRAVITY_FORMS_BASE_URL` (and consumer key/secret). The rest of the client and AuthManager work unchanged. — `config/test-config.js:60-95`, `gravity-forms-client.js:16`
339
+
12.**Test mode resolves env vars at client construction.** When `GRAVITYKIT_MCP_TEST_MODE=true` (or legacy `GRAVITYMCP_TEST_MODE=true`), `testConfig.resolveEnv()` remaps `GRAVITY_FORMS_TEST_BASE_URL` → `GRAVITY_FORMS_BASE_URL` (and consumer key/secret). The rest of the client and AuthManager work unchanged. — `config/test-config.js:60-95`, `gravity-forms-client.js:16`
340
340
341
341
## Releasing
342
342
@@ -345,7 +345,7 @@ No build step — pure ESM JavaScript, runs directly with `node src/index.js`. R
345
345
1.**Update `CHANGELOG.md`** — add a new `## [X.Y.Z] - YYYY-MM-DD` section with all changes since the last release. Follow [Keep a Changelog](https://keepachangelog.com/) format (Added, Changed, Fixed, Removed).
346
346
2.**Bump `version` in `package.json`**
347
347
3.**Update version in `CLAUDE.md`** (Project Identity → Package line)
348
-
4.**Add link** at bottom of `CHANGELOG.md`: `[X.Y.Z]: https://github.com/GravityKit/GravityMCP/releases/tag/vX.Y.Z`
348
+
4.**Add link** at bottom of `CHANGELOG.md`: `[X.Y.Z]: https://github.com/GravityKit/MCP/releases/tag/vX.Y.Z`
349
349
5.**Commit**: `git commit -m "chore(release): bump version to X.Y.Z"`
- MCP server name: `gravitymcp` → `gravitykit-mcp`
15
+
- CLI binary: `gravitymcp` → `gkmcp`
16
+
- Environment variable: `GRAVITYKIT_MCP_TEST_MODE` (legacy `GRAVITYMCP_TEST_MODE` still supported)
17
+
- User-Agent header updated to `GravityKit MCP/2.0.0`
18
+
19
+
### Backwards Compatibility
20
+
- The old `@gravitykit/gravitymcp` npm package is published as a bridge that depends on `@gravitykit/mcp` with a deprecation notice — existing installs continue working
21
+
- GitHub auto-redirects old repo URL (`GravityKit/GravityMCP`) to the new one
22
+
-`GRAVITYMCP_TEST_MODE` environment variable still works alongside new `GRAVITYKIT_MCP_TEST_MODE`
23
+
8
24
## [1.4.1] - 2026-03-20
9
25
10
26
### Fixed
@@ -131,12 +147,13 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
@@ -36,7 +36,7 @@ Required env vars (see `.env.example` for full list):
36
36
6.**Minimize response tokens** — no pretty-print (`JSON.stringify(result)` not `null, 2`), no redundant `message` strings, no echo-back of input IDs, no `created`/`updated` booleans. Return only essential data.
37
37
7.**Keep tool descriptions terse** — every token in tool schemas is sent on every `tools/list` call
38
38
8.**Compact mode strips null, empty strings, and entry meta** — `stripEmpty()` in `utils/compact.js` runs on all responses. Entry tools also strip plugin-added meta keys via `stripEntryMeta()`, keeping only core properties and field values. `false` is preserved. Pass `compact=false` for full raw data.
39
-
9.**Test mode uses dev site** — when `GRAVITYMCP_TEST_MODE=true`, the client auto-resolves `GRAVITY_FORMS_TEST_*` env vars to connect to the test site instead of production. Resolution logic lives in `testConfig.resolveEnv()` in `config/test-config.js`.
39
+
9.**Test mode uses dev site** — when `GRAVITYKIT_MCP_TEST_MODE=true` (or legacy `GRAVITYMCP_TEST_MODE=true`), the client auto-resolves `GRAVITY_FORMS_TEST_*` env vars to connect to the test site instead of production. Resolution logic lives in `testConfig.resolveEnv()` in `config/test-config.js`.
0 commit comments