{"_id":"@admon-protocol/mcp-server","_rev":"4-4a5259838bf4c56c062a4bafa4d6fb1c","name":"@admon-protocol/mcp-server","dist-tags":{"latest":"0.1.3"},"versions":{"0.1.0":{"name":"@admon-protocol/mcp-server","version":"0.1.0","license":"MIT","_id":"@admon-protocol/mcp-server@0.1.0","maintainers":[{"name":"chanlian","email":"1511044739@qq.com"}],"homepage":"https://github.com/XuetaoZhang/AdMon/tree/main/mcp-server","bugs":{"url":"https://github.com/XuetaoZhang/AdMon/issues"},"bin":{"admon-mcp":"dist/cli.js"},"dist":{"shasum":"9f5788db388e044a6fd4f4b27ad8a27cc0f5991f","tarball":"https://registry.npmjs.org/@admon-protocol/mcp-server/-/mcp-server-0.1.0.tgz","fileCount":5,"integrity":"sha512-tmo2G6+oD9EEajiwq00+SRElqRPw7Jwu1HphvHZAh7eQWcw3gNYdl79BkYJB4VrSZtI/1SvL6qXus7nlhc2Evg==","signatures":[{"sig":"MEUCIQDmcqCGWBHJJOoblp3UYhVuA5kqYSvgPLBEZ99hWoWxwQIgQJqhwc7A2ehRXVTVkYpr2NY1IMyMiFICZgYj80XJjY8=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":19631},"type":"module","engines":{"node":">=20"},"gitHead":"6bbca0e5143a42d803f01ff9adbac01cb6023c15","scripts":{"test":"vitest run","build":"tsup src/cli.ts --format esm --dts --sourcemap --clean --target node22","prepublishOnly":"npm run build"},"_npmUser":{"name":"chanlian","email":"1511044739@qq.com"},"repository":{"url":"git+https://github.com/XuetaoZhang/AdMon.git","type":"git","directory":"mcp-server"},"_npmVersion":"10.9.2","description":"AdMon MCP publisher connector for transparent sponsored offers on Monad","directories":{},"_nodeVersion":"23.10.0","dependencies":{"zod":"^3.25.76","@modelcontextprotocol/sdk":"^1.30.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.5.1","vitest":"^3.2.4","typescript":"^5.9.2","@types/node":"^22.18.1"},"_npmOperationalInternal":{"tmp":"tmp/mcp-server_0.1.0_1786070534914_0.07066503065162344","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@admon-protocol/mcp-server","version":"0.1.1","license":"MIT","_id":"@admon-protocol/mcp-server@0.1.1","maintainers":[{"name":"chanlian","email":"1511044739@qq.com"}],"homepage":"https://github.com/XuetaoZhang/AdMon/tree/main/mcp-server","bugs":{"url":"https://github.com/XuetaoZhang/AdMon/issues"},"bin":{"admon-mcp":"dist/cli.js"},"dist":{"shasum":"1259be151968ccadad76027d7ef61d5c794c18d9","tarball":"https://registry.npmjs.org/@admon-protocol/mcp-server/-/mcp-server-0.1.1.tgz","fileCount":5,"integrity":"sha512-eoX7dCua/f7moOy9FC8LHdmo6Rd6zRG0O8epnLIVPVHotcrbQa1KMGYhbt6VAZ7kyIimYxfz5lBLyjEUuJZj0w==","signatures":[{"sig":"MEQCICmhW8Pm/0yTJA5UHaJxT4iD+AaQo8osbuJhQwbYhoe6AiBWAxarC2mgIlRAyTUL35axbOTToLdX7eErSxVvKQE9AQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":53391},"type":"module","engines":{"node":">=20"},"gitHead":"fb592b624278c706b43658a3a67a66c3176a1a10","scripts":{"test":"vitest run","build":"tsup src/cli.ts --format esm --dts --sourcemap --clean --target node22","prepublishOnly":"npm run build"},"_npmUser":{"name":"chanlian","email":"1511044739@qq.com"},"repository":{"url":"git+https://github.com/XuetaoZhang/AdMon.git","type":"git","directory":"mcp-server"},"_npmVersion":"10.9.2","description":"AdMon MCP publisher connector for transparent sponsored offers on Monad","directories":{},"_nodeVersion":"23.10.0","dependencies":{"zod":"^3.25.76","@modelcontextprotocol/sdk":"^1.30.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.5.1","vitest":"^3.2.4","typescript":"^5.9.2","@types/node":"^22.18.1"},"_npmOperationalInternal":{"tmp":"tmp/mcp-server_0.1.1_1786101050353_0.12986466824910692","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"@admon-protocol/mcp-server","version":"0.1.2","license":"MIT","_id":"@admon-protocol/mcp-server@0.1.2","maintainers":[{"name":"chanlian","email":"1511044739@qq.com"}],"homepage":"https://github.com/XuetaoZhang/AdMon/tree/main/mcp-server","bugs":{"url":"https://github.com/XuetaoZhang/AdMon/issues"},"bin":{"admon-mcp":"dist/cli.js"},"dist":{"shasum":"cf1a2d651565f43840449b49a9df2e3f4ec8e5ca","tarball":"https://registry.npmjs.org/@admon-protocol/mcp-server/-/mcp-server-0.1.2.tgz","fileCount":5,"integrity":"sha512-jyaL5ecFpHBSF2Xs5hIT0kvpBii70YMoKqqjOfLQO56YlEtP4g16xJyp19oYw+9fX7NrWpJvVETX8uxRoX6FUA==","signatures":[{"sig":"MEUCIQDwJkwpVUIqliJM8qpU/bEJrRRst9dDM9bDQXVdu3bL6QIgSFAGRwhsfuG5SxByzFK3W9nIgMugh2ZVHLQUMR8fono=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":55056},"type":"module","engines":{"node":">=20"},"gitHead":"3947817db729d231b256e0229b1554fe6a0f11f5","scripts":{"test":"vitest run","build":"tsup src/cli.ts --format esm --dts --sourcemap --clean --target node22","prepublishOnly":"npm run build"},"_npmUser":{"name":"chanlian","email":"1511044739@qq.com"},"repository":{"url":"git+https://github.com/XuetaoZhang/AdMon.git","type":"git","directory":"mcp-server"},"_npmVersion":"10.9.2","description":"AdMon MCP publisher connector for transparent sponsored offers on Monad","directories":{},"_nodeVersion":"23.10.0","dependencies":{"zod":"^3.25.76","@modelcontextprotocol/sdk":"^1.30.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.5.1","vitest":"^3.2.4","typescript":"^5.9.2","@types/node":"^22.18.1"},"_npmOperationalInternal":{"tmp":"tmp/mcp-server_0.1.2_1786104473538_0.677240687851467","host":"s3://npm-registry-packages-npm-production"}},"0.1.3":{"name":"@admon-protocol/mcp-server","version":"0.1.3","type":"module","description":"AdMon MCP publisher connector for transparent sponsored offers on Monad","license":"MIT","repository":{"type":"git","url":"git+https://github.com/XuetaoZhang/AdMon.git","directory":"mcp-server"},"bugs":{"url":"https://github.com/XuetaoZhang/AdMon/issues"},"homepage":"https://github.com/XuetaoZhang/AdMon/tree/main/mcp-server","engines":{"node":">=20"},"publishConfig":{"access":"public"},"bin":{"admon-mcp":"dist/cli.js"},"scripts":{"build":"tsup src/cli.ts --format esm --dts --sourcemap --clean --target node22","prepublishOnly":"npm run build","test":"vitest run"},"dependencies":{"@modelcontextprotocol/sdk":"^1.30.0","zod":"^3.25.76"},"devDependencies":{"@types/node":"^22.18.1","tsup":"^8.5.1","typescript":"^5.9.2","vitest":"^3.2.4"},"_id":"@admon-protocol/mcp-server@0.1.3","gitHead":"3947817db729d231b256e0229b1554fe6a0f11f5","_nodeVersion":"23.10.0","_npmVersion":"10.9.2","dist":{"integrity":"sha512-2sHc1fdMtbFXcD5MSk9jeeNfOWTLSd9BlFNoPPxbclblXLug3BSsgYMV/OJy9K8c/tkQmV/rmLpw84euMYG2Uw==","shasum":"c253925189b0c9009cab961f3968df91569ea444","tarball":"https://registry.npmjs.org/@admon-protocol/mcp-server/-/mcp-server-0.1.3.tgz","fileCount":5,"unpackedSize":55759,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIEfn8ZQQnjGMOj06wD9/5WRQ609CSD4KwhARnOD8hxqNAiA+DsmYttKCH8GAKkEoit0TZ+1FdGYBVlcllI0daWOjRA=="}]},"_npmUser":{"name":"chanlian","email":"1511044739@qq.com"},"directories":{},"maintainers":[{"name":"chanlian","email":"1511044739@qq.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-server_0.1.3_1786106021969_0.5398333416404513"},"_hasShrinkwrap":false}},"time":{"created":"2026-08-07T02:42:14.730Z","modified":"2026-08-07T12:33:42.312Z","0.1.0":"2026-08-07T02:42:15.076Z","0.1.1":"2026-08-07T11:10:50.550Z","0.1.2":"2026-08-07T12:07:53.686Z","0.1.3":"2026-08-07T12:33:42.121Z"},"bugs":{"url":"https://github.com/XuetaoZhang/AdMon/issues"},"license":"MIT","homepage":"https://github.com/XuetaoZhang/AdMon/tree/main/mcp-server","repository":{"type":"git","url":"git+https://github.com/XuetaoZhang/AdMon.git","directory":"mcp-server"},"description":"AdMon MCP publisher connector for transparent sponsored offers on Monad","maintainers":[{"name":"chanlian","email":"1511044739@qq.com"}],"readme":"# AdMon MCP\n\nThis MCP server runs locally in an agent host and calls the shared AdMon HTTP API. It does not store campaigns or hold funds.\n\n## Install from npm\n\nAn MCP host can start the published package without cloning the repository:\n\n```bash\nnpx -y @admon-protocol/mcp-server\n```\n\nThe package is configured with `ADMON_API_URL` and `ADMON_PUBLISHER_ADDRESS` environment variables in the host configuration.\n\nThe corresponding host entry is:\n\n```json\n{\n  \"mcpServers\": {\n    \"admon\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@admon-protocol/mcp-server\"],\n      \"env\": {\n        \"ADMON_API_URL\": \"https://your-admon.vercel.app\",\n        \"ADMON_PUBLISHER_ADDRESS\": \"0xYourPublisherWallet\",\n        \"ADMON_USER_ADDRESS\": \"0xYourUserRewardWallet\"\n      }\n    }\n  }\n}\n```\n\n## Initialize a host project\n\nFrom a project that should show AdMon sponsored results, install the host policy, skill, and MCP configuration in one command. Installation is the project owner's workspace-level opt-in to transparent sponsored results:\n\n```bash\nnpx -y @admon-protocol/mcp-server init \\\n  --host claude \\\n  --publisher 0xYourPublisherWallet \\\n  --user 0xYourUserRewardWallet\n```\n\n`claude` installs project-scoped `.mcp.json`, `CLAUDE.md`, and the Claude skill; it is the default interactive choice. `codex` installs `AGENTS.md` and the Codex skill, then registers the MCP through `codex mcp add` when the CLI is available. Without the CLI, it succeeds and prints the exact MCP configuration for Codex Desktop settings. The initializer preserves unrelated project instructions and MCP servers. It only accepts public addresses and never requests a private key.\n\nUse `--force` to replace a conflicting AdMon entry and `--skip-codex-mcp` to install only the Codex project files. Run `npx -y @admon-protocol/mcp-server init --help` for all options.\n\n## Build from source\n\n```bash\ngit clone https://github.com/XuetaoZhang/AdMon.git\ncd AdMon\nnpm ci\nnpm run build --workspace @admon-protocol/mcp-server\n```\n\nConfigure the host with the absolute path to `mcp-server/dist/cli.js`:\n\n```json\n{\n  \"mcpServers\": {\n    \"admon\": {\n      \"command\": \"node\",\n      \"args\": [\"/absolute/path/AdMon/mcp-server/dist/cli.js\"],\n      \"env\": {\n        \"ADMON_API_URL\": \"https://your-admon.vercel.app\",\n        \"ADMON_PUBLISHER_ADDRESS\": \"0xYourPublisherWallet\",\n        \"ADMON_USER_ADDRESS\": \"0xYourUserRewardWallet\"\n      }\n    }\n  }\n}\n```\n\nThe host extracts intent keywords locally and calls `get_ad_offer` with those keywords and the user's reward address. The raw conversation is not sent to AdMon. The returned structured offer includes a transparent sponsored card and a one-time click URL.\n\nClaude Code can register the same server with:\n\n```bash\nclaude mcp add --transport stdio admon \\\n  --env ADMON_API_URL=https://your-admon.vercel.app \\\n  --env ADMON_PUBLISHER_ADDRESS=0xYourPublisherWallet \\\n  --env ADMON_USER_ADDRESS=0xYourUserRewardWallet \\\n  -- node /absolute/path/AdMon/mcp-server/dist/cli.js\n```\n\nCodex CLI can register it globally with:\n\n```bash\ncodex mcp add admon \\\n  --env ADMON_API_URL=https://your-admon.vercel.app \\\n  --env ADMON_PUBLISHER_ADDRESS=0xYourPublisherWallet \\\n  --env ADMON_USER_ADDRESS=0xYourUserRewardWallet \\\n  -- node /absolute/path/AdMon/mcp-server/dist/cli.js\n```\n\nWith `ADMON_USER_ADDRESS` configured, `get_ad_offer` only needs the extracted keywords. A host may still pass `userAddress` explicitly when the reward wallet changes per session.\n","readmeFilename":"README.md"}