{"_id":"google-tag-manager-mcp-core","_rev":"6-00382ed07df2f3a9a41b6e1c1f58b5f4","name":"google-tag-manager-mcp-core","dist-tags":{"latest":"3.0.1"},"versions":{"1.0.0":{"name":"google-tag-manager-mcp-core","version":"1.0.0","keywords":["mcp","modelcontextprotocol","gtm","stape"],"author":{"name":"stape-io"},"license":"Apache-2.0","_id":"google-tag-manager-mcp-core@1.0.0","maintainers":[{"name":"stape-admin","email":"denis@stape.io"}],"homepage":"https://github.com/stape-io/google-tag-manager-mcp-server","bugs":{"url":"https://github.com/stape-io/google-tag-manager-mcp-server/issues"},"dist":{"shasum":"e3f82df6fdbaaba5ef36ba64ab845c9b155cefcf","tarball":"https://registry.npmjs.org/google-tag-manager-mcp-core/-/google-tag-manager-mcp-core-1.0.0.tgz","fileCount":293,"integrity":"sha512-JQSndqpbSGk9wb++AukSrrP8iy1coMFtIqtvjoJE2wK64bK4bP1FnguUsVUTc6LCZYD+IZRl7t/FHXIpipPtwQ==","signatures":[{"sig":"MEUCIQCXc2k+SRsLFQPiztpZq9JqwNvle1mvr5orHbzOKZm1WwIgFWBxytOsnPoeAVyj+JSXEg6nFqnYqL+GMQDUwfPY6/g=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":715467},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=20"},"exports":{".":{"types":"./dist/index.d.ts","default":"./dist/index.js"}},"gitHead":"5ba1172efcb6e856c27c850a83c4fd2d14e0703f","scripts":{"lint":"eslint src","build":"tsc -p tsconfig.json","clean":"rm -rf dist","lint:fix":"eslint src --fix","prebuild":"node ../../scripts/generate-version.mjs","prepublishOnly":"npm run build"},"_npmUser":{"name":"stape-admin","email":"denis@stape.io"},"repository":{"url":"git+https://github.com/stape-io/google-tag-manager-mcp-server.git","type":"git","directory":"packages/core"},"_npmVersion":"11.17.0","description":"Reusable Google Tag Manager MCP tools, schemas and pluggable auth providers","directories":{},"sideEffects":false,"_nodeVersion":"24.19.0","dependencies":{"@googleapis/tagmanager":"^16.0.0"},"_hasShrinkwrap":false,"devDependencies":{"zod":"^3.22.4","typescript":"^5.8.3","@types/node":"^24.0.0","@modelcontextprotocol/sdk":"^1.30.0"},"peerDependencies":{"zod":"^3.22.4","@modelcontextprotocol/sdk":">=1.18.1 <2"},"_npmOperationalInternal":{"tmp":"tmp/google-tag-manager-mcp-core_1.0.0_1786964802349_0.3571711755926896","host":"s3://npm-registry-packages-npm-production"}},"2.0.0":{"name":"google-tag-manager-mcp-core","version":"2.0.0","keywords":["mcp","modelcontextprotocol","gtm","stape"],"author":{"name":"stape-io"},"license":"Apache-2.0","_id":"google-tag-manager-mcp-core@2.0.0","maintainers":[{"name":"stape-admin","email":"denis@stape.io"}],"homepage":"https://github.com/stape-io/google-tag-manager-mcp-server","bugs":{"url":"https://github.com/stape-io/google-tag-manager-mcp-server/issues"},"dist":{"shasum":"2dd39a97508e075a74ebdeaae1b2259ad5de1fe3","tarball":"https://registry.npmjs.org/google-tag-manager-mcp-core/-/google-tag-manager-mcp-core-2.0.0.tgz","fileCount":293,"integrity":"sha512-F+Ntf/Zzxp8YSDJNCcSxRQAYGXU+OAApoLVyAIa9qSDJscgXBdu2rJ0uQehd+z1+2Aio3WWowvd/CwoTfdrXJQ==","signatures":[{"sig":"MEQCIA50QGpaeaCsO35GcXw1Cf56hFqPgLbizLSrD3eqy9KpAiAwVq25oIm8uC69efms2H3h88UjWGdD73QjY9JYpPinNQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":629309},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=20"},"exports":{".":{"types":"./dist/index.d.ts","default":"./dist/index.js"}},"gitHead":"e46ee152167cc95eac69c2c526989792df05be67","scripts":{"lint":"eslint src","build":"tsc -p tsconfig.json","clean":"rm -rf dist","lint:fix":"eslint src --fix","prebuild":"node ../../scripts/generate-version.mjs","typecheck":"tsc -p tsconfig.json --noEmit","prepublishOnly":"npm run build"},"_npmUser":{"name":"stape-admin","email":"denis@stape.io"},"repository":{"url":"git+https://github.com/stape-io/google-tag-manager-mcp-server.git","type":"git","directory":"packages/core"},"_npmVersion":"11.17.0","description":"Reusable Google Tag Manager MCP tools, schemas and pluggable auth providers","directories":{},"sideEffects":false,"_nodeVersion":"24.19.0","dependencies":{"@googleapis/tagmanager":"^16.0.0"},"_hasShrinkwrap":false,"devDependencies":{"zod":"^4.4.3","typescript":"^5.8.3","@types/node":"^24.0.0","@modelcontextprotocol/sdk":"^1.30.0"},"peerDependencies":{"zod":"^4.4.3","@modelcontextprotocol/sdk":">=1.18.1 <2"},"_npmOperationalInternal":{"tmp":"tmp/google-tag-manager-mcp-core_2.0.0_1787330365498_0.5119886440703936","host":"s3://npm-registry-packages-npm-production"}},"2.1.0":{"name":"google-tag-manager-mcp-core","version":"2.1.0","keywords":["mcp","modelcontextprotocol","gtm","stape"],"author":{"name":"stape-io"},"license":"Apache-2.0","_id":"google-tag-manager-mcp-core@2.1.0","maintainers":[{"name":"stape-admin","email":"denis@stape.io"}],"homepage":"https://github.com/stape-io/google-tag-manager-mcp-server","bugs":{"url":"https://github.com/stape-io/google-tag-manager-mcp-server/issues"},"dist":{"shasum":"82a7ba945fa25180283a4e19f928c3cdaee999ba","tarball":"https://registry.npmjs.org/google-tag-manager-mcp-core/-/google-tag-manager-mcp-core-2.1.0.tgz","fileCount":293,"integrity":"sha512-QbQ4dtH2Gv/PQCYzouHbS/A55xvapzogzH/WJFuPY04F9iDRfCg76Hy4xtE6LIlpaL7KuRsXg5Ord9lKBGrNrA==","signatures":[{"sig":"MEYCIQCamf5kzw2pAn5bZE8nyKVJ9SsFqgiV7rSlbqrL87MuxAIhANnCtYKeb90q65mhS5KNwenjIzp6n5Xtvjm8m7MnSUQj","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":622407},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=20"},"exports":{".":{"types":"./dist/index.d.ts","default":"./dist/index.js"}},"gitHead":"0ad2abeb25802a1c6e80b067f61a8f2f7be69631","scripts":{"lint":"eslint src","build":"tsc -p tsconfig.json","clean":"rm -rf dist","lint:fix":"eslint src --fix","prebuild":"node ../../scripts/generate-version.mjs","typecheck":"tsc -p tsconfig.json --noEmit","prepublishOnly":"npm run build"},"_npmUser":{"name":"stape-admin","email":"denis@stape.io"},"repository":{"url":"git+https://github.com/stape-io/google-tag-manager-mcp-server.git","type":"git","directory":"packages/core"},"_npmVersion":"11.17.0","description":"Reusable Google Tag Manager MCP tools, schemas and pluggable auth providers","directories":{},"sideEffects":false,"_nodeVersion":"24.19.0","dependencies":{"@googleapis/tagmanager":"^16.0.0"},"_hasShrinkwrap":false,"devDependencies":{"zod":"^4.4.3","typescript":"^5.8.3","@types/node":"^24.0.0","@modelcontextprotocol/sdk":"^1.30.0"},"peerDependencies":{"zod":"^4.4.3","@modelcontextprotocol/sdk":">=1.18.1 <2"},"_npmOperationalInternal":{"tmp":"tmp/google-tag-manager-mcp-core_2.1.0_1787659003793_0.3904306612483115","host":"s3://npm-registry-packages-npm-production"}},"2.1.1":{"name":"google-tag-manager-mcp-core","version":"2.1.1","keywords":["mcp","modelcontextprotocol","gtm","stape"],"author":{"name":"stape-io"},"license":"Apache-2.0","_id":"google-tag-manager-mcp-core@2.1.1","maintainers":[{"name":"stape-admin","email":"denis@stape.io"}],"homepage":"https://github.com/stape-io/google-tag-manager-mcp-server","bugs":{"url":"https://github.com/stape-io/google-tag-manager-mcp-server/issues"},"dist":{"shasum":"e82d4859d48bba5873b9ebd352135ba39d9e8aa8","tarball":"https://registry.npmjs.org/google-tag-manager-mcp-core/-/google-tag-manager-mcp-core-2.1.1.tgz","fileCount":293,"integrity":"sha512-XeLZ0Mmi/kM2w1KK93zdCv8V9VNvLPkwmetzyXIUH/5vZHY2YIXRptVp6JevPFZFJjZ9/ysk23kGWHc2MjNjUg==","signatures":[{"sig":"MEYCIQCtOOFd5CU1RJTrbM21p04sbgFTEBvQ7iAy+sOUm+988wIhAOCyVHoVVYTE9nT/IusNUvJ/Ao1xkzCM+XSdEutno8KQ","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":627596},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=20"},"exports":{".":{"types":"./dist/index.d.ts","default":"./dist/index.js"}},"gitHead":"9cb9ea7f183d370f75757dd24103311b96e88477","scripts":{"lint":"eslint src","build":"tsc -p tsconfig.json","clean":"rm -rf dist","lint:fix":"eslint src --fix","prebuild":"node ../../scripts/generate-version.mjs","typecheck":"tsc -p tsconfig.json --noEmit","prepublishOnly":"npm run build"},"_npmUser":{"name":"stape-admin","email":"denis@stape.io"},"repository":{"url":"git+https://github.com/stape-io/google-tag-manager-mcp-server.git","type":"git","directory":"packages/core"},"_npmVersion":"11.17.0","description":"Reusable Google Tag Manager MCP tools, schemas and pluggable auth providers","directories":{},"sideEffects":false,"_nodeVersion":"24.19.0","dependencies":{"@googleapis/tagmanager":"^16.0.0"},"_hasShrinkwrap":false,"devDependencies":{"zod":"^4.4.3","typescript":"^5.8.3","@types/node":"^24.0.0","@modelcontextprotocol/sdk":"^1.30.0"},"peerDependencies":{"zod":"^4.4.3","@modelcontextprotocol/sdk":">=1.18.1 <2"},"_npmOperationalInternal":{"tmp":"tmp/google-tag-manager-mcp-core_2.1.1_1788361889000_0.29032958654412155","host":"s3://npm-registry-packages-npm-production"}},"3.0.0":{"name":"google-tag-manager-mcp-core","version":"3.0.0","keywords":["mcp","modelcontextprotocol","gtm","stape"],"author":{"name":"stape-io"},"license":"Apache-2.0","_id":"google-tag-manager-mcp-core@3.0.0","maintainers":[{"name":"stape-admin","email":"denis@stape.io"}],"homepage":"https://github.com/stape-io/google-tag-manager-mcp-server","bugs":{"url":"https://github.com/stape-io/google-tag-manager-mcp-server/issues"},"dist":{"shasum":"2dc9124f9eb1b7323e3d5a1424b97877564a5388","tarball":"https://registry.npmjs.org/google-tag-manager-mcp-core/-/google-tag-manager-mcp-core-3.0.0.tgz","fileCount":303,"integrity":"sha512-2RTNzBGtR4qFST5P5kinFX0y4GV2SFd+WDYjczqhG6uGCNk1qXtOCpsIA5kRnXC3H8oAKHctQF9H8us3yFGB2w==","signatures":[{"sig":"MEYCIQDa07v4V152BWR0WmkPSC8hMCzCX158Svvf2PqRLs5CZQIhAK+967MUBrdkBRwFqlqKJxXOkEakIdrvVNGJQj/GEFi+","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCIC3fTr355SSaKuBFv9nnJ2Ln+4jZ/JukuJsAySv3BhvhAiEAzunx6+Soq4eUQGICgRqvpBJ7rGpqfaSiVBA0UwFQbFE=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":684275},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=20"},"exports":{".":{"types":"./dist/index.d.ts","default":"./dist/index.js"}},"gitHead":"5211ed33c52a7b94e3938a981df03dc739d9741a","scripts":{"lint":"eslint src","test":"vitest run","build":"tsc -p tsconfig.json","clean":"rm -rf dist","lint:fix":"eslint src --fix","prebuild":"node ../../scripts/generate-version.mjs","typecheck":"tsc -p tsconfig.json --noEmit && tsc -p tsconfig.test.json --noEmit","prepublishOnly":"npm run build","test:golden:update":"vitest run --config vitest.golden.config.ts"},"_npmUser":{"name":"stape-admin","email":"denis@stape.io"},"repository":{"url":"git+https://github.com/stape-io/google-tag-manager-mcp-server.git","type":"git","directory":"packages/core"},"_npmVersion":"11.19.0","description":"Reusable Google Tag Manager MCP tools, schemas and pluggable auth providers","directories":{},"sideEffects":false,"_nodeVersion":"24.21.0","dependencies":{"@googleapis/tagmanager":"^16.0.0"},"_hasShrinkwrap":false,"devDependencies":{"zod":"^4.4.3","vitest":"^3.2.4","typescript":"^5.8.3","@types/node":"^24.0.0","@modelcontextprotocol/client":"^2.0.0","@modelcontextprotocol/server":"^2.0.0"},"peerDependencies":{"zod":"^4.4.3","@modelcontextprotocol/server":"^2.0.0"},"_npmOperationalInternal":{"tmp":"tmp/google-tag-manager-mcp-core_3.0.0_1791298982300_0.44212314242669093","host":"s3://npm-registry-packages-npm-production"}},"3.0.1":{"_id":"google-tag-manager-mcp-core@3.0.1","bugs":{"url":"https://github.com/stape-io/google-tag-manager-mcp-server/issues"},"dist":{"shasum":"f67da63d0c34d4f0199db0aa35197914870fd833","tarball":"https://registry.npmjs.org/google-tag-manager-mcp-core/-/google-tag-manager-mcp-core-3.0.1.tgz","fileCount":303,"integrity":"sha512-Knx5UIG9MljkZc0R/D2OltdIf63eUrO3uwogaPC9zE0PT+CCo2b4DkqIXhBD642LQA/WyG3aVDbd/v2bnDQKcA==","signatures":[{"sig":"MEUCICyc3wgECC90JZlQVTxeJLepnbb59zbINLMnQXEoj+0kAiEAybg/3+ykS1tHvxM1h1olufDvRB09T1lvVLU6IoKJjck=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQC61bvkcU+s9lp8qppN/rHJzu+gOUyD9b1YY0uK8P0KNQIgcedcyqgjf4+pZYv3vVyRoV1oVf79wU3LoqEIs6phzT4="}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/google-tag-manager-mcp-core@3.0.1","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":684275},"main":"./dist/index.js","name":"google-tag-manager-mcp-core","type":"module","types":"./dist/index.d.ts","author":{"name":"stape-io"},"engines":{"node":">=20"},"exports":{".":{"types":"./dist/index.d.ts","default":"./dist/index.js"}},"gitHead":"be78139cb8cbf22fab15a33f477eb6b5de1427a3","license":"Apache-2.0","scripts":{"lint":"eslint src","test":"vitest run","build":"tsc -p tsconfig.json","clean":"rm -rf dist","lint:fix":"eslint src --fix","prebuild":"node ../../scripts/generate-version.mjs","typecheck":"tsc -p tsconfig.json --noEmit && tsc -p tsconfig.test.json --noEmit","prepublishOnly":"npm run build","test:golden:update":"vitest run --config vitest.golden.config.ts"},"version":"3.0.1","_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"042425e5-9281-4fe0-b8bb-0d73c9329f8d"}},"homepage":"https://github.com/stape-io/google-tag-manager-mcp-server","keywords":["mcp","modelcontextprotocol","gtm","stape"],"repository":{"url":"git+https://github.com/stape-io/google-tag-manager-mcp-server.git","type":"git","directory":"packages/core"},"_npmVersion":"11.19.0","description":"Reusable Google Tag Manager MCP tools, schemas and pluggable auth providers","directories":{},"maintainers":[{"name":"stape-admin","email":"denis@stape.io"}],"sideEffects":false,"_nodeVersion":"24.21.0","dependencies":{"@googleapis/tagmanager":"^16.0.0"},"_hasShrinkwrap":false,"devDependencies":{"zod":"^4.4.3","vitest":"^3.2.4","typescript":"^5.8.3","@types/node":"^24.0.0","@modelcontextprotocol/client":"^2.0.0","@modelcontextprotocol/server":"^2.0.0"},"peerDependencies":{"zod":"^4.4.3","@modelcontextprotocol/server":"^2.0.0"},"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/google-tag-manager-mcp-core_3.0.1_1792169635879_0.5822514094697973"}}},"time":{"created":"2026-08-17T11:06:42.058Z","modified":"2026-10-16T16:53:56.418Z","1.0.0":"2026-08-17T11:06:42.515Z","2.0.0":"2026-08-21T16:39:25.650Z","2.1.0":"2026-08-25T11:56:43.942Z","2.1.1":"2026-09-02T15:11:29.141Z","3.0.0":"2026-10-06T15:03:02.418Z","3.0.1":"2026-10-16T16:53:56.037Z"},"bugs":{"url":"https://github.com/stape-io/google-tag-manager-mcp-server/issues"},"author":{"name":"stape-io"},"license":"Apache-2.0","homepage":"https://github.com/stape-io/google-tag-manager-mcp-server","keywords":["mcp","modelcontextprotocol","gtm","stape"],"repository":{"url":"git+https://github.com/stape-io/google-tag-manager-mcp-server.git","type":"git","directory":"packages/core"},"description":"Reusable Google Tag Manager MCP tools, schemas and pluggable auth providers","maintainers":[{"name":"stape-admin","email":"denis@stape.io"}],"readme":"# google-tag-manager-mcp-core\n\nThe reusable half of the [Google Tag Manager MCP server](https://github.com/stape-io/google-tag-manager-mcp-server): every GTM tool, its input schemas and helpers, with **no opinion about how credentials are obtained**.\n\nAuthentication is a single interface, so the same tool set can back a public server doing per-user Google OAuth, a private server holding its own service account, or anything else:\n\n```ts\nexport interface GtmAuthProvider {\n  getAccessToken(): Promise<string>;\n}\n```\n\nThe package is runtime agnostic — it runs on Cloudflare Workers and in Node (token signing uses WebCrypto, not Node-only APIs).\n\n## Install\n\n```bash\nnpm install google-tag-manager-mcp-core\n```\n\n`@modelcontextprotocol/sdk` and `zod` are peer dependencies on purpose: the SDK identifies tool schemas with `instanceof` checks, so core and the host server have to share one copy of each. If the host pins an exact SDK version (the `agents` package does), match that version in your own `package.json` so npm hoists a single copy.\n\n## Usage\n\n### A standalone server\n\n```ts\nimport {\n  createGtmMcpServer,\n  createServiceAccountAuth,\n  parseServiceAccountKey,\n} from \"google-tag-manager-mcp-core\";\n\nconst server = createGtmMcpServer({\n  auth: createServiceAccountAuth({\n    ...parseServiceAccountKey(process.env.GOOGLE_SERVICE_ACCOUNT_KEY!),\n    // Optional: impersonate a user through domain-wide delegation.\n    subject: process.env.GOOGLE_IMPERSONATED_USER,\n  }),\n  serverInfo: { name: \"my-gtm-mcp-server\", version: \"1.0.0\" },\n});\n\nawait server.connect(transport);\n```\n\n### Tools on a server you already own\n\nWhen the `McpServer` instance belongs to a framework (an `McpAgent` subclass, for example), register the tools onto it instead:\n\n```ts\nimport { registerGtmTools } from \"google-tag-manager-mcp-core\";\n\nregisterGtmTools(this.server, { auth });\n```\n\nTo change which tools get registered: `createGtmMcpServer` takes `tools` (replaces the default set) and `extraTools` (added on top), while `registerGtmTools` takes the registrations to use as its third argument.\n\n```ts\nregisterGtmTools(this.server, { auth }, [...tools, myPrivateTool]);\n```\n\n### Custom auth\n\nAnything that can produce an access token works — a token vault, an internal auth service, per-request credentials:\n\n```ts\nconst auth: GtmAuthProvider = {\n  async getAccessToken() {\n    return myAuthBackend.getGoogleTokenFor(currentUser);\n  },\n};\n```\n\n`getAccessToken()` is called on every tool invocation, so providers should cache and refresh internally. `createCachedTokenSource()` is exported for that: it reuses a token until just before it expires and collapses concurrent refreshes into one request.\n\n## Built-in auth providers\n\n| Provider | Use it when |\n| --- | --- |\n| `createStaticTokenAuth({ accessToken, expiresAt })` | Some other layer already ran an OAuth flow and stores the token per session. Pass a function instead of an object when that session's token can be refreshed while the server runs. |\n| `createRefreshTokenAuth({ clientId, clientSecret, refreshToken })` | The server owns one Google account's credentials and mints access tokens itself. |\n| `createServiceAccountAuth({ clientEmail, privateKey, subject })` | The server authenticates as a service account (JWT bearer flow, RS256 via WebCrypto). Grant that service account access to the GTM accounts it manages, or use `subject` for domain-wide delegation. |\n\n## Also exported\n\n- `tools` — the default tool registrations, and each action module individually.\n- All request schemas (`TagSchema`, `TriggerSchema`, `VariableSchema`, …).\n- `GTM_API_SCOPES` / `GTM_OAUTH_SCOPES`, `GOOGLE_AUTHORIZE_URL`, `GOOGLE_TOKEN_URL`.\n- `getTagManagerClient(auth)`, `createErrorResponse`, pagination helpers.\n- `setLogSink()` — required for stdio servers, where stdout is the JSON-RPC stream and logs must go to stderr.\n\n## License\n\nApache-2.0\n","readmeFilename":"README.md"}