Skip to content

Commit 5adc715

Browse files
committed
chore(release): rename GravityMCP to GravityKit MCP v2.0.0
- npm: @gravitykit/gravitymcp → @gravitykit/mcp - GitHub: GravityKit/GravityMCP → GravityKit/MCP - Server name: gravitymcp → gravitykit-mcp - CLI bin: gravitymcp → gkmcp - Env var: GRAVITYKIT_MCP_TEST_MODE (legacy GRAVITYMCP_TEST_MODE still works) - WordPress page slug: /mcp-for-gravity-forms/ → /mcp/ - User-Agent: GravityKit-MCP/2.0.0
1 parent 3eb35df commit 5adc715

13 files changed

Lines changed: 84 additions & 65 deletions

File tree

.env.example

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
# Gravity MCP Configuration
1+
# GravityKit MCP Configuration
22

33
# Required: Gravity Forms REST API v2 Credentials
44
# Generate these in your WordPress admin: Forms > Settings > REST API
@@ -54,4 +54,5 @@ GRAVITY_FORMS_TEST_CONSUMER_KEY=ck_test_key_here
5454
GRAVITY_FORMS_TEST_CONSUMER_SECRET=cs_test_secret_here
5555

5656
# Enable test mode (MCP-specific setting)
57-
# GRAVITYMCP_TEST_MODE=true
57+
# GRAVITYKIT_MCP_TEST_MODE=true
58+
# Legacy name also supported: GRAVITYMCP_TEST_MODE=true

.github/workflows/publish.yml

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -52,11 +52,11 @@ jobs:
5252
## Installation
5353
5454
```bash
55-
npm install @gravitykit/gravitymcp@${{ github.ref_name }}
55+
npm install @gravitykit/mcp@${{ github.ref_name }}
5656
```
57-
57+
5858
## npm Package
59-
60-
View on npm: https://www.npmjs.com/package/@gravitykit/gravitymcp
59+
60+
View on npm: https://www.npmjs.com/package/@gravitykit/mcp
6161
draft: false
6262
prerelease: false

.mcp.json

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
{
2-
"name": "gravitymcp",
2+
"name": "gravitykit-mcp",
33
"version": "1.0.0",
44
"description": "MCP server for Gravity Forms",
55
"command": "node",
@@ -184,8 +184,8 @@
184184
"metadata": {
185185
"author": "GravityKit",
186186
"license": "MIT",
187-
"repository": "https://github.com/GravityKit/GravityMCP",
188-
"documentation": "https://github.com/GravityKit/GravityMCP#readme",
187+
"repository": "https://github.com/GravityKit/MCP",
188+
"documentation": "https://github.com/GravityKit/MCP#readme",
189189
"api_coverage": "100%",
190190
"total_tools": 24,
191191
"authentication_methods": ["OAuth 1.0a", "Basic Authentication"],

AGENTS.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
# AGENTS.md — GravityMCP
1+
# AGENTS.md — GravityKit MCP
22

33
> 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.
44
@@ -13,8 +13,8 @@
1313
## Repository Map
1414

1515
```
16-
gravitymcp/
17-
├── package.json # @gravitykit/gravitymcp, ESM, npm scripts
16+
MCP/
17+
├── package.json # @gravitykit/mcp, ESM, npm scripts
1818
├── mcp.json # MCP manifest (tool catalog, auth config)
1919
├── .env.example # All env vars documented
2020
├── CLAUDE.md # Project docs for AI context
@@ -336,7 +336,7 @@ No build step — pure ESM JavaScript, runs directly with `node src/index.js`. R
336336

337337
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`
338338

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`
340340

341341
## Releasing
342342

@@ -345,7 +345,7 @@ No build step — pure ESM JavaScript, runs directly with `node src/index.js`. R
345345
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).
346346
2. **Bump `version` in `package.json`**
347347
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`
349349
5. **Commit**: `git commit -m "chore(release): bump version to X.Y.Z"`
350350
6. **Tag**: `git tag vX.Y.Z`
351351
7. **Push**: `git push origin main --tags`

CHANGELOG.md

Lines changed: 27 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,26 @@
11
# Changelog
22

3-
All notable changes to GravityMCP will be documented in this file.
3+
All notable changes to GravityKit MCP (formerly GravityMCP) will be documented in this file.
44

55
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
66
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
77

8+
## [2.0.0] - 2026-03-31
9+
10+
### Changed
11+
- **Renamed project from GravityMCP to GravityKit MCP**
12+
- npm package: `@gravitykit/gravitymcp``@gravitykit/mcp`
13+
- GitHub repo: `GravityKit/GravityMCP``GravityKit/MCP`
14+
- 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+
824
## [1.4.1] - 2026-03-20
925

1026
### Fixed
@@ -131,12 +147,13 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
131147
- Field filters (1 tool)
132148
- Results/Analytics (1 tool)
133149

134-
[1.4.1]: https://github.com/GravityKit/GravityMCP/releases/tag/v1.4.1
135-
[1.4.0]: https://github.com/GravityKit/GravityMCP/releases/tag/v1.4.0
136-
[1.3.0]: https://github.com/GravityKit/GravityMCP/releases/tag/v1.3.0
137-
[1.1.0]: https://github.com/GravityKit/GravityMCP/releases/tag/v1.1.0
138-
[1.0.5]: https://github.com/GravityKit/GravityMCP/releases/tag/v1.0.5
139-
[1.0.4]: https://github.com/GravityKit/GravityMCP/releases/tag/v1.0.4
140-
[1.0.3]: https://github.com/GravityKit/GravityMCP/releases/tag/v1.0.3
141-
[1.0.2]: https://github.com/GravityKit/GravityMCP/releases/tag/v1.0.2
142-
[1.0.1]: https://github.com/GravityKit/GravityMCP/releases/tag/v1.0.1
150+
[2.0.0]: https://github.com/GravityKit/MCP/releases/tag/v2.0.0
151+
[1.4.1]: https://github.com/GravityKit/MCP/releases/tag/v1.4.1
152+
[1.4.0]: https://github.com/GravityKit/MCP/releases/tag/v1.4.0
153+
[1.3.0]: https://github.com/GravityKit/MCP/releases/tag/v1.3.0
154+
[1.1.0]: https://github.com/GravityKit/MCP/releases/tag/v1.1.0
155+
[1.0.5]: https://github.com/GravityKit/MCP/releases/tag/v1.0.5
156+
[1.0.4]: https://github.com/GravityKit/MCP/releases/tag/v1.0.4
157+
[1.0.3]: https://github.com/GravityKit/MCP/releases/tag/v1.0.3
158+
[1.0.2]: https://github.com/GravityKit/MCP/releases/tag/v1.0.2
159+
[1.0.1]: https://github.com/GravityKit/MCP/releases/tag/v1.0.1

CLAUDE.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,13 +1,13 @@
11
You MUST fully ingest @AGENTS.md first.
22

3-
# Gravity MCP Server
3+
# GravityKit MCP Server
44

55
## Project Identity
66

7-
- **Package:** `@gravitykit/gravitymcp` v1.4.1
7+
- **Package:** `@gravitykit/mcp` v2.0.0
88
- **Type:** Node.js MCP server (ESM)
99
- **Purpose:** Full Gravity Forms REST API v2 coverage via 28 MCP tools
10-
- **Repo:** https://github.com/GravityKit/GravityMCP
10+
- **Repo:** https://github.com/GravityKit/MCP
1111

1212
## Key Commands
1313

@@ -36,7 +36,7 @@ Required env vars (see `.env.example` for full list):
3636
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.
3737
7. **Keep tool descriptions terse** — every token in tool schemas is sent on every `tools/list` call
3838
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`.
4040

4141
## Release Checklist
4242

README.md

Lines changed: 12 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,8 @@
1-
# MCP for Gravity Forms
1+
# GravityKit MCP
22

33
A Model Context Protocol (MCP) server for Gravity Forms. Interact with your WordPress forms, feeds, and entries through any MCP-compatible client.
44

5-
[![npm version](https://img.shields.io/npm/v/@gravitykit/gravitymcp.svg)](https://www.npmjs.com/package/@gravitykit/gravitymcp)
5+
[![npm version](https://img.shields.io/npm/v/@gravitykit/mcp.svg)](https://www.npmjs.com/package/@gravitykit/mcp)
66

77
Built by [GravityKit](https://www.gravitykit.com) for the Gravity Forms community.
88

@@ -27,8 +27,8 @@ Built by [GravityKit](https://www.gravitykit.com) for the Gravity Forms communit
2727

2828
1. **Clone the repository**
2929
```bash
30-
git clone https://github.com/GravityKit/GravityMCP.git
31-
cd GravityMCP
30+
git clone https://github.com/GravityKit/MCP.git
31+
cd MCP
3232
npm install
3333
```
3434

@@ -61,9 +61,9 @@ Built by [GravityKit](https://www.gravitykit.com) for the Gravity Forms communit
6161
```json
6262
{
6363
"mcpServers": {
64-
"gravitymcp": {
64+
"gravitykit-mcp": {
6565
"command": "node",
66-
"args": ["/path/to/GravityMCP/src/index.js"],
66+
"args": ["/path/to/MCP/src/index.js"],
6767
"env": {
6868
"GRAVITY_FORMS_CONSUMER_KEY": "your_key",
6969
"GRAVITY_FORMS_CONSUMER_SECRET": "your_secret",
@@ -181,7 +181,7 @@ GRAVITY_FORMS_TEST_CONSUMER_SECRET=cs_test_secret
181181
GRAVITY_FORMS_TEST_BASE_URL=https://staging.yoursite.com
182182
183183
# Enable test mode (optional)
184-
GRAVITY_MCP_TEST_MODE=true
184+
GRAVITYKIT_MCP_TEST_MODE=true
185185
```
186186

187187
### Test Environment Features
@@ -196,7 +196,7 @@ When using test configuration:
196196

197197
```bash
198198
# Verify test environment configuration
199-
GRAVITY_MCP_TEST_MODE=true npm run check-env
199+
GRAVITYKIT_MCP_TEST_MODE=true npm run check-env
200200

201201
# Create test data on test site (requires test credentials)
202202
npm run setup-test-data
@@ -205,7 +205,7 @@ npm run setup-test-data
205205
npm test
206206

207207
# Interactive testing with MCP Inspector (test mode)
208-
GRAVITYMCP_TEST_MODE=true npm run inspect
208+
GRAVITYKIT_MCP_TEST_MODE=true npm run inspect
209209

210210
# Run specific test suites against test site
211211
NODE_ENV=test npm run test:forms
@@ -216,7 +216,7 @@ NODE_ENV=test npm run test:submissions
216216
### Test Mode Detection
217217

218218
The server automatically uses test configuration when:
219-
1. `GRAVITYMCP_TEST_MODE=true` is set
219+
1. `GRAVITYKIT_MCP_TEST_MODE=true` is set (or legacy `GRAVITYMCP_TEST_MODE=true`)
220220
2. OR `NODE_ENV=test` is set
221221
3. OR test credentials are configured and test commands are run
222222

@@ -293,7 +293,7 @@ GRAVITY_FORMS_DEBUG=true
293293

294294
## Support
295295

296-
- [GitHub Issues](https://github.com/GravityKit/GravityMCP/issues)
296+
- [GitHub Issues](https://github.com/GravityKit/MCP/issues)
297297
- [Gravity Forms Documentation](https://docs.gravityforms.com/rest-api-v2/)
298298
- [MCP Documentation](https://modelcontextprotocol.io/)
299299

@@ -337,7 +337,7 @@ This repository uses GitHub Actions to automatically publish to npm when a new v
337337
- Enhance error messages and debugging
338338

339339
**For Everyone:**
340-
- Report bugs or suggest features via [GitHub Issues](https://github.com/GravityKit/GravityMCP/issues)
340+
- Report bugs or suggest features via [GitHub Issues](https://github.com/GravityKit/MCP/issues)
341341
- Improve documentation and examples
342342
- Share your use cases and workflows
343343

mcp.json

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
{
2-
"name": "gravitymcp",
3-
"version": "1.4.1",
2+
"name": "gravitykit-mcp",
3+
"version": "2.0.0",
44
"description": "MCP server for Gravity Forms",
55
"author": "GravityKit",
66
"license": "MIT",

package-lock.json

Lines changed: 5 additions & 5 deletions
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

package.json

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,11 @@
11
{
2-
"name": "@gravitykit/gravitymcp",
3-
"version": "1.4.1",
2+
"name": "@gravitykit/mcp",
3+
"version": "2.0.0",
44
"description": "Full-featured MCP server for Gravity Forms",
55
"main": "src/index.js",
66
"type": "module",
77
"bin": {
8-
"gravitymcp": "src/index.js"
8+
"gkmcp": "src/index.js"
99
},
1010
"scripts": {
1111
"start": "node src/index.js",
@@ -58,12 +58,12 @@
5858
],
5959
"repository": {
6060
"type": "git",
61-
"url": "git+https://github.com/GravityKit/GravityMCP.git"
61+
"url": "git+https://github.com/GravityKit/MCP.git"
6262
},
6363
"bugs": {
64-
"url": "https://github.com/GravityKit/GravityMCP/issues"
64+
"url": "https://github.com/GravityKit/MCP/issues"
6565
},
66-
"homepage": "https://github.com/GravityKit/GravityMCP#readme",
66+
"homepage": "https://github.com/GravityKit/MCP#readme",
6767
"publishConfig": {
6868
"access": "public"
6969
},

0 commit comments

Comments
 (0)