docs: transition Code Assist MCP to remote endpoint by ryanbaumann · Pull Request #64 · googlemaps/platform-ai

ryanbaumann · 2026-03-06T22:22:06Z

Note: This PR is dependent on another PR that will deprecate all of the old self-hosted version code on NPM. We have added a notice in the README that the NPM version will be deprecated and will no longer be available as of [XX date - to be completed]. Please use the securely hosted remote version as the primary connection method.

⚠️ DO NOT MERGE until the updated Code Assist MCP server is successfully launched and deployed.

This PR updates the Code Assist MCP server documentation and configurations to strictly support the modern remote Streamable HTTP endpoint (https://mapscodeassist.googleapis.com/mcp) while informing developers that the old NPM version is depricated.

Key Changes

Transports Corrected: Ensured all client configurations use http / streamable-http / httpUrl parameters rather than legacy sse.
Removed Local Setup: Stripped all references to local npm installs, Cloud Run deployments, and legacy clients.
Client Configuration: Added config how-to's for Gemini CLI, Antigravity, Claude Code, Cursor, Codex, and Antigravity.
- Standardized Gemini CLI instructions to use httpUrl
- Added CLI-first approaches for Claude Code (claude mcp add) and Codex (codex mcp add).
- Added TOML fallback configurations for Codex.
Gemini CLI Extension Marketplace: Updated gemini-extension.json to use a "skill" vs. a "GEMINI.md" file, renamed the skill to gmp-code-assist, and bundled the new skill.md with the gemini extension.
Set server name to gmp-code-assist across the readme to prevent "too long of name" errors on certain clients.

…tions

… official schemas

…Streamable HTTP

…GEMINI.md

… SKILL.md for Gemini CLI discovery

…nstallation paths for Gemini CLI and Antigravity MCPs

…eprecation notice Note: This PR is dependent on another upcoming PR that will deprecate all of the old self-hosted version code on NPM. We have added a notice in the README that the NPM version will be deprecated and will no longer be available as of [XX date - to be completed]. Users should use the securely hosted remote version as the primary connection method, as referenced in this README. - Renamed skill and MCP server references to strictly use 'gmp-code-assist' - Updated MCP tools descriptions in READMEs to perfectly match the 'retrieve-google-maps-platform-docs' and 'retrieve-instructions' endpoints. - Removed arbitrary 'vibecoding' language for safer enterprise tone. - Ensured total consistency across root README, package README, GEMINI.md, and skill specs.

…AG reasoning strategies

ryanbaumann · 2026-03-06T23:11:42Z

Ready for a first 👓 @caio1985

ryanbaumann · 2026-03-06T23:12:47Z

-  2. **`retrieve-google-maps-platform-docs`**: The primary tool. It takes a natural language query and submits it to a hosted Retrieval Augmented Generation (RAG) engine. The RAG engine searches fresh versions of official Google Maps Platform documentation, tutorials, and code samples, returning relevant context to the AI to generate an accurate response.
-<!-- [END maps_Tools] -->
+1. **`retrieve-google-maps-platform-docs`**: Searches Google Maps Platform documentation, code samples, architecture center, and GitHub repositories via RAG.
+   - *Parameters*: `llmQuery` (Required string query), `filter` (Optional API/product area filter), `source` (Optional string caller identifier up to 64 chars).


TBD: should we add a source parameter by default to the docs on how to install?

ryanbaumann · 2026-03-06T23:13:18Z

- **HTTP `/health` Endpoint**: A simple `GET` request to this endpoint (e.g., `https://your-service-url/health`) will return a `200 OK` status with a JSON payload containing the server status, number of active sessions, and a timestamp if the server is running. This is used for infrastructure-level health checks.
- **MCP `ping` Utility**: This is different from the in-protocol `ping` utility defined by the MCP specification. The `ping` utility is a JSON-RPC request sent *after* a session is established to check the liveness of the *protocol connection*, whereas the `/health` endpoint checks the liveness of the *HTTP server* itself.
+> [!WARNING]
+> We will be deprecating the version of this package on NPM, and it will no longer be available as of [XX date - to be completed]. Please use the securely hosted remote version as the primary method of connection, as documented below.


to update: Date of deprication

updated gemini cli commit link

small readme updates on human copy review

Updated README.md to improve clarity and remove deprecated information.

caio1985 · 2026-04-23T19:18:00Z

@ryanbaumann let's start this deprecation if possible as I'm unable to call npm deprecate :(

There's just one comment from Angela that needs to be addressed.

ryanbaumann · 2026-04-23T20:03:13Z

Great. I'll take a look this evening

ryanbaumann · 2026-04-24T23:53:58Z

@caio1985 @wangela

I've just pushed an update to address the feedback:

Tool Order: Reordered the tools list in the README so retrieve-instructions is correctly listed first.
Deprecation Language: Updated the README and package.json to explicitly state the package is deprecated (rather than "will
be").
Marked this PR "ready for review" from Draft

Final decision needed:

Decommission Date: To address Angela's feedback, I added a placeholder date of June 1, 2026 as the official turn-down date in the README and package.json deprecation warnings. What date do we want to use here?

Note: I have not yet run the npm deprecate command to push the deprecation notice to the live NPM registry. I am holding off on running that until we confirm the final decommission date and merge this PR.

snippet-bot · 2026-04-24T23:54:05Z

Here is the summary of changes.

You are about to delete 3 region tags.

packages/code-assist/README.md:75, tag maps_LocalSetup
packages/code-assist/README.md:239, tag maps_Settings
packages/code-assist/README.md:294, tag maps_StreamableHTTP_Guide

This comment is generated by snippet-bot.
If you find problems with this result, please file an issue at:
https://github.com/googleapis/repo-automation-bots/issues.
To update this comment, add snippet-bot:force-run label or use the checkbox below:

Refresh this comment

wangela

Overall, 30 days is very short for a deprecation window. Can we support for at least 60 days (July 1, 2026)?

Updated deprecation notice for NPM version of Code Assist with specific date.

Updated benefits section to clarify features and support for various AI agents.

ryanbaumann · 2026-05-01T02:26:14Z

Thanks @wangela - comments addressed. Once LGTM , I will move to merge this PR and mark the code Assist npm package deprecated cc/ @caio1985

ryanbaumann added 13 commits March 6, 2026 13:21

docs: switch MCP to remote SSE and update marketplace integrations

c4d7c3d

docs: refine MCP configuration instructions and CLI commands for clients

c34c283

docs: fix Codex TOML MCP configuration and refine Claude Code instruc…

d05be01

…tions

docs: fix Gemini CLI MCP transport flags and JSON config

d6a9b73

chore: align gemini-extension.json and Codex TOML configurations with…

4213e7f

… official schemas

docs: fix transport terminology across clients to accurately reflect …

5a15ffd

…Streamable HTTP

docs: append MCP configuration learnings and official client docs to …

ced7e4c

…GEMINI.md

chore: remove orphaned text files

03e8e6f

fix(skills): add missing YAML frontmatter to google-maps-platform-dev…

213c99b

… SKILL.md for Gemini CLI discovery

docs: add Android Studio setup instructions and clarify marketplace i…

acf8177

…nstallation paths for Gemini CLI and Antigravity MCPs

docs: strip redundant MCP schemas from skill.md and focus purely on R…

3730c9b

…AG reasoning strategies

docs: soften rigid commands in skill prompt with explanatory reasoning

c0f1847

ryanbaumann commented Mar 6, 2026

View reviewed changes

ryanbaumann added 3 commits March 7, 2026 08:01

Update installation link in README.md

1c026f0

updated gemini cli commit link

Update README.md

99058af

small readme updates on human copy review

human review: README for clarity and updated usage

1097f94

Updated README.md to improve clarity and remove deprecated information.

caio1985 approved these changes Mar 9, 2026

View reviewed changes

wangela requested changes Mar 17, 2026

View reviewed changes

Comment thread packages/code-assist/README.md

Comment thread packages/code-assist/README.md Outdated

docs: deprecate code assist npm package, address PR feedback

e65868a

ryanbaumann marked this pull request as ready for review April 24, 2026 23:54

wangela requested changes Apr 30, 2026

View reviewed changes

Comment thread README.md Outdated

Comment thread README.md

Comment thread packages/code-assist/README.md Outdated

Comment thread packages/code-assist/package.json Outdated

Comment thread packages/code-assist/README.md

ryanbaumann added 3 commits April 30, 2026 19:17

Revise deprecation notice in README

722ece2

Updated deprecation notice for NPM version of Code Assist with specific date.

retrieve-instructions first in tool list

58d7e37

Revise benefits section in README.md

2bfc348

Updated benefits section to clarify features and support for various AI agents.

Update deprecation date in package.json

11cb13f

Conversation

ryanbaumann commented Mar 6, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Key Changes

Uh oh!

ryanbaumann commented Mar 6, 2026

Uh oh!

ryanbaumann Mar 6, 2026

Choose a reason for hiding this comment

Uh oh!

ryanbaumann Mar 6, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

caio1985 commented Apr 23, 2026

Uh oh!

ryanbaumann commented Apr 23, 2026 via email • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

ryanbaumann commented Apr 24, 2026

Final decision needed:

Uh oh!

snippet-bot Bot commented Apr 24, 2026

Uh oh!

wangela left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

ryanbaumann commented May 1, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

ryanbaumann commented Mar 6, 2026 •

edited

Loading

ryanbaumann commented Apr 23, 2026 via email •

edited

Loading