# Mcp Google Map Project

> Project knowledge for developing and maintaining @cablate/mcp-google-map. Architecture, Google Maps API guide, GIS domain knowledge, and design decisions. Read this skill to onboard onto the project or make informed development decisions.

- **Type:** Skill
- **Install:** `agentstack add skill-cablate-mcp-google-map-project-docs`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [cablate](https://agentstack.voostack.com/s/cablate)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [cablate](https://github.com/cablate)
- **Source:** https://github.com/cablate/mcp-google-map/tree/main/skills/project-docs

## Install

```sh
agentstack add skill-cablate-mcp-google-map-project-docs
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# mcp-google-map — Project Knowledge

## Overview

This skill contains everything needed to develop, maintain, and extend the `@cablate/mcp-google-map` MCP server. Reading these files gives you full context on architecture, API specifics, domain knowledge, and the reasoning behind design decisions.

For the **agent skill** (how to USE the tools), see `skills/google-maps/SKILL.md`.

---

## Quick Orientation

| Aspect | Summary |
|--------|---------|
| **What** | MCP server providing Google Maps tools for AI agents |
| **Stack** | TypeScript, Node.js, Express, MCP SDK, Zod |
| **Tools** | 17 tools (14 atomic + 3 composite) |
| **Transports** | stdio, Streamable HTTP, standalone exec CLI |
| **APIs** | Places API (New), Directions, Geocoding, Elevation, Timezone, Weather, Air Quality, Static Maps, Search Along Route |

---

## Reference Files

| File | Content | When to read |
|------|---------|--------------|
| `references/architecture.md` | System architecture, 3-layer design, transport modes, tool registration flow, 9-file checklist, code map | **Start here** when onboarding. Also read when adding new tools. |
| `references/google-maps-api-guide.md` | All Google Maps API endpoints used, pricing, coverage limits, rate limits, common gotchas, Places New vs Legacy | When debugging API errors, evaluating new APIs, or checking costs |
| `references/geo-domain-knowledge.md` | GIS fundamentals — coordinates, distance, geocoding, place types, spatial search, map projection, Japan-specific knowledge | When making tool design decisions that involve geographic concepts |
| `references/decisions.md` | 10 Architecture Decision Records (ADR) with context and rationale | When asking "why was X built this way?" or considering changes to existing design |

---

## How to Add a New Tool

See `references/architecture.md` § "9-File Tool Change Checklist" for the complete procedure. Summary:

1. Create `src/tools/maps/.ts` (NAME, DESCRIPTION, SCHEMA, ACTION)
2. Register in `src/config.ts`
3. Add exec case in `src/cli.ts`
4. Add to `tests/smoke.test.ts` (expectedTools + API call test)
5. Update `README.md` (count + table + exec list + project structure)
6. Update `skills/google-maps/SKILL.md` (Tool Map)
7. Update `skills/google-maps/references/tools-api.md` (params + chaining)
8. Check `server.json` and `package.json` descriptions

---

## When to Update This Skill

| Trigger | What to update |
|---------|----------------|
| Architecture change | `references/architecture.md` |
| New Google Maps API integrated | `references/google-maps-api-guide.md` |
| New design decision made | `references/decisions.md` (add ADR) |
| New GIS concept relevant to tools | `references/geo-domain-knowledge.md` |

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [cablate](https://github.com/cablate)
- **Source:** [cablate/mcp-google-map](https://github.com/cablate/mcp-google-map)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-cablate-mcp-google-map-project-docs
- Seller: https://agentstack.voostack.com/s/cablate
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.