{"_id":"@agentmark-ai/mcp-server","_rev":"9-c0f8bf986cf3caada07ce9fb11748c8e","name":"@agentmark-ai/mcp-server","dist-tags":{"latest":"0.4.2"},"versions":{"0.1.0":{"name":"@agentmark-ai/mcp-server","version":"0.1.0","license":"MIT","_id":"@agentmark-ai/mcp-server@0.1.0","maintainers":[{"name":"rrandall","email":"ryan@agentmark.co"},{"name":"kashi11","email":"kashif.ali@carbonteq.com"}],"bin":{"agentmark-mcp":"dist/bin.mjs"},"dist":{"shasum":"fe9692e70118c42a608aa90a31c4f7573f0129ff","tarball":"https://registry.npmjs.org/@agentmark-ai/mcp-server/-/mcp-server-0.1.0.tgz","fileCount":8,"integrity":"sha512-jQFRU+bhcbnOWz/1kjuLH9njYrC/CZgSIPWegYzslRQ3jXi6h7ory6rv92Sacl1aF6X0UQlr79ZbTT7zyYKZog==","signatures":[{"sig":"MEYCIQC88N0u4zIkTeJU86yYMQLrSWNatNbBRR88M1GMioBYHQIhAPNfb+avFm0hx3aDYUoE3V1hfyV9YotrZZMIYmeA+dDW","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":88397},"main":"./dist/index.mjs","type":"module","types":"./dist/index.d.mts","engines":{"node":">=18.0.0"},"gitHead":"863a8fa59e2d39be3e4b2e5ef963e73469f94b9d","scripts":{"dev":"tsup --config tsup.index.config.ts --watch","lint":"eslint .","test":"vitest run test/unit","build":"tsup --config tsup.index.config.ts && tsup --config tsup.bin.config.ts","test:integration":"cross-env RUN_INTEGRATION_TESTS=true vitest run test/integration"},"_npmUser":{"name":"kashi11","email":"kashif.ali@carbonteq.com"},"_npmVersion":"10.5.0","description":"MCP server for AgentMark trace debugging","directories":{},"_nodeVersion":"21.7.3","dependencies":{"zod":"^3.25.0","@modelcontextprotocol/sdk":"^1.11.0"},"_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.5.1","eslint":"^9","vitest":"^3.1.4","cross-env":"^7.0.3","typescript":"^5","@types/node":"^20","@agentmark-ai/eslint-config":"*"},"_npmOperationalInternal":{"tmp":"tmp/mcp-server_0.1.0_1768814881568_0.08314277788830005","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"@agentmark-ai/mcp-server","version":"0.2.0","license":"MIT","_id":"@agentmark-ai/mcp-server@0.2.0","maintainers":[{"name":"rrandall","email":"ryan@agentmark.co"},{"name":"kashi11","email":"kashif.ali@carbonteq.com"}],"bin":{"agentmark-mcp":"dist/bin.mjs"},"dist":{"shasum":"c48a5a06f7ea294f0055db4a5637701ab3f939a6","tarball":"https://registry.npmjs.org/@agentmark-ai/mcp-server/-/mcp-server-0.2.0.tgz","fileCount":8,"integrity":"sha512-DNuz5WW1SKZQCcA0nb8PIHMhTBWnXaPl1HjTkjnGmFOcX7zmsuFf/iB56IZmw0qhvSQ7jlFFyNof2u6pr5t0Jg==","signatures":[{"sig":"MEQCIBacw3TCYLi8V65aHYKRK9g4CppbeLHspidDOp3FaSu3AiA4Vsj6ksI8wWKS/LntaHGiv13M2sOXqGZvRkII2LCbpA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":88397},"main":"./dist/index.mjs","type":"module","types":"./dist/index.d.mts","engines":{"node":">=18.0.0"},"gitHead":"6b4d81a7a2ee373b44644f642fee0edd5f5b046c","scripts":{"dev":"tsup --config tsup.index.config.ts --watch","lint":"eslint .","test":"vitest run test/unit","build":"tsup --config tsup.index.config.ts && tsup --config tsup.bin.config.ts","test:integration":"cross-env RUN_INTEGRATION_TESTS=true vitest run test/integration"},"_npmUser":{"name":"kashi11","email":"kashif.ali@carbonteq.com"},"_npmVersion":"10.5.0","description":"MCP server for AgentMark trace debugging","directories":{},"_nodeVersion":"21.7.3","dependencies":{"zod":"^3.25.0","@modelcontextprotocol/sdk":"^1.25.2"},"_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.5.1","eslint":"^9","vitest":"^3.1.4","cross-env":"^7.0.3","typescript":"^5","@types/node":"^20","@agentmark-ai/eslint-config":"*"},"_npmOperationalInternal":{"tmp":"tmp/mcp-server_0.2.0_1769002340082_0.14290369460466024","host":"s3://npm-registry-packages-npm-production"}},"0.2.1":{"name":"@agentmark-ai/mcp-server","version":"0.2.1","license":"MIT","_id":"@agentmark-ai/mcp-server@0.2.1","maintainers":[{"name":"rrandall","email":"ryan@agentmark.co"},{"name":"kashi11","email":"kashif.ali@carbonteq.com"}],"bin":{"agentmark-mcp":"dist/bin.js"},"dist":{"shasum":"85d1352c2563d6ed04b24901f711825093349388","tarball":"https://registry.npmjs.org/@agentmark-ai/mcp-server/-/mcp-server-0.2.1.tgz","fileCount":8,"integrity":"sha512-0leQ0wv8oA7LqeIrFERZKkN5gdJTl2EVIc2eJsBtSB+vxLRQ+jIbjN3TmshFylHA+L2EYaFb/yKg836/TRZDxA==","signatures":[{"sig":"MEYCIQDBczpOi8MTciouMEg/c5gDM1pME43Rw4+MBOyutLhXrAIhAJ59Z4wfOLPwTadtycD0t+4POgsA/izL5pdSKrUEADbk","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":88394},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"fb90f6189f11a73dfa95e938f76c11d6db873c90","scripts":{"dev":"tsup --config tsup.index.config.ts --watch","lint":"eslint .","test":"vitest run test/unit","build":"tsup --config tsup.index.config.ts && tsup --config tsup.bin.config.ts","test:integration":"cross-env RUN_INTEGRATION_TESTS=true vitest run test/integration"},"_npmUser":{"name":"kashi11","email":"kashif.ali@carbonteq.com"},"_npmVersion":"10.5.0","description":"MCP server for AgentMark trace debugging","directories":{},"_nodeVersion":"21.7.3","dependencies":{"zod":"^3.25.0","@modelcontextprotocol/sdk":"^1.25.2"},"_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.5.1","eslint":"^9","vitest":"^3.1.4","cross-env":"^7.0.3","typescript":"^5","@types/node":"^20","@agentmark-ai/eslint-config":"*"},"_npmOperationalInternal":{"tmp":"tmp/mcp-server_0.2.1_1770986054442_0.3292283686134474","host":"s3://npm-registry-packages-npm-production"}},"0.2.2":{"name":"@agentmark-ai/mcp-server","version":"0.2.2","license":"AGPL-3.0-or-later","_id":"@agentmark-ai/mcp-server@0.2.2","maintainers":[{"name":"rrandall","email":"ryan@agentmark.co"},{"name":"kashi11","email":"kashif.ali@carbonteq.com"}],"bin":{"agentmark-mcp":"dist/bin.js"},"dist":{"shasum":"3cfbd4724e5d87e19e8a097512f871ae3e9637fc","tarball":"https://registry.npmjs.org/@agentmark-ai/mcp-server/-/mcp-server-0.2.2.tgz","fileCount":8,"integrity":"sha512-2Tj3JdLL7++Gh2ES3FjZ09wJ9coBu5KEuuZilOG7wYR5K1jBiwnF5na5hhFSOK4ilYI3qcuYiFoIfKGOBoh/gA==","signatures":[{"sig":"MEQCIDfbNvrSPjYGwGkHzlD0CklH3it5so9c17tQ7OQF4tx7AiACkkhAbiRkKo2xUujHdhaUwnRxxQHTswSG/yukMaw40A==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":113149},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"996b716c314d92792a8030f256f1ba29b7bb9c7b","scripts":{"dev":"tsup --config tsup.index.config.ts --watch","lint":"eslint .","test":"vitest run test/unit","build":"tsup --config tsup.index.config.ts && tsup --config tsup.bin.config.ts","test:integration":"cross-env RUN_INTEGRATION_TESTS=true vitest run test/integration"},"_npmUser":{"name":"kashi11","email":"kashif.ali@carbonteq.com"},"_npmVersion":"10.5.0","description":"MCP server for AgentMark trace debugging","directories":{},"_nodeVersion":"21.7.3","dependencies":{"zod":"^3.25.0","@modelcontextprotocol/sdk":"^1.25.2"},"_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.5.1","eslint":"^9","vitest":"^3.1.4","cross-env":"^7.0.3","typescript":"^5","@types/node":"^20","@agentmark-ai/eslint-config":"*"},"_npmOperationalInternal":{"tmp":"tmp/mcp-server_0.2.2_1778587199416_0.3179044896889591","host":"s3://npm-registry-packages-npm-production"}},"0.3.0":{"name":"@agentmark-ai/mcp-server","version":"0.3.0","license":"AGPL-3.0-or-later","_id":"@agentmark-ai/mcp-server@0.3.0","maintainers":[{"name":"rrandall","email":"ryan@agentmark.co"},{"name":"kashi11","email":"kashif.ali@carbonteq.com"}],"bin":{"agentmark-mcp":"dist/bin.js"},"dist":{"shasum":"ee35189c631f0c2e51d63871b9f80ce95d314fed","tarball":"https://registry.npmjs.org/@agentmark-ai/mcp-server/-/mcp-server-0.3.0.tgz","fileCount":8,"integrity":"sha512-pdGXOZhTfWfpXD/uJPXu5sisNLmIVwTxUVsw/pCZ6GVegzBN7UUvmpQ2t9c6ZrP1na/7S+ZCXdU+U2o1cOToTw==","signatures":[{"sig":"MEUCIQCVVVUmJ2VWV28k65y8blL3tRzTyGxeUcDXYd8tEnp9xQIgd9GeuLaw4aQNV6FnZeqKpmJpCHXid3idnt0+U6a+8QQ=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":112838},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"76a29e939c4a9d9de29917c59e620f3b134bc984","scripts":{"dev":"tsup --config tsup.index.config.ts --watch","lint":"eslint .","test":"vitest run test/unit","build":"tsup --config tsup.index.config.ts && tsup --config tsup.bin.config.ts"},"_npmUser":{"name":"kashi11","email":"kashif.ali@carbonteq.com"},"_npmVersion":"10.9.8","description":"MCP server for AgentMark trace debugging","directories":{},"_nodeVersion":"22.22.3","dependencies":{"zod":"^3.25.0","@modelcontextprotocol/sdk":"^1.25.2"},"_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.5.1","eslint":"^9","vitest":"^4.1.8","cross-env":"^7.0.3","typescript":"^5","@types/node":"^20","@agentmark-ai/eslint-config":"*"},"_npmOperationalInternal":{"tmp":"tmp/mcp-server_0.3.0_1780662217905_0.43738073406035083","host":"s3://npm-registry-packages-npm-production"}},"0.3.1":{"name":"@agentmark-ai/mcp-server","version":"0.3.1","license":"AGPL-3.0-or-later","_id":"@agentmark-ai/mcp-server@0.3.1","maintainers":[{"name":"rrandall","email":"ryan@agentmark.co"},{"name":"kashi11","email":"kashif.ali@carbonteq.com"}],"bin":{"agentmark-mcp":"dist/bin.js"},"dist":{"shasum":"9903220e3b58c7806821df3a370801b9d7af4406","tarball":"https://registry.npmjs.org/@agentmark-ai/mcp-server/-/mcp-server-0.3.1.tgz","fileCount":8,"integrity":"sha512-xBq0NeKMhRN6SONIslFExWcYiy8zEI4UlqjvZV+YMFyHciDCjxD1rfDtRyYLqh4hayfHvpLZSS1XpAkShYNGSw==","signatures":[{"sig":"MEQCIEDrL0Tl4K+XeLd8bGBzgiutpsSfcnu7jHSQq4J1C2c4AiBJ8j8riyiA4tvLhV+Ih9wQhJHh0Nhh5oJP3lIKgouReg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":126526},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"a365eea3d7097f70f965e82226295ab4432a3afe","scripts":{"dev":"tsup --config tsup.index.config.ts --watch","lint":"eslint .","test":"vitest run test/unit","build":"tsup --config tsup.index.config.ts && tsup --config tsup.bin.config.ts"},"_npmUser":{"name":"kashi11","email":"kashif.ali@carbonteq.com"},"_npmVersion":"10.9.8","description":"MCP server for AgentMark trace debugging","directories":{},"_nodeVersion":"22.22.3","dependencies":{"zod":"^3.25.0","@modelcontextprotocol/sdk":"^1.25.2"},"_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.5.1","eslint":"^9","vitest":"^4.1.8","cross-env":"^7.0.3","typescript":"^5","@types/node":"^20","@agentmark-ai/eslint-config":"*"},"_npmOperationalInternal":{"tmp":"tmp/mcp-server_0.3.1_1780943005715_0.9634097683207854","host":"s3://npm-registry-packages-npm-production"}},"0.4.0":{"name":"@agentmark-ai/mcp-server","version":"0.4.0","license":"AGPL-3.0-or-later","_id":"@agentmark-ai/mcp-server@0.4.0","maintainers":[{"name":"rrandall","email":"ryan@agentmark.co"},{"name":"kashi11","email":"kashif.ali@carbonteq.com"}],"bin":{"agentmark-mcp":"dist/bin.js"},"dist":{"shasum":"963b1b950e08b9557006200335d2d65b5117ef6c","tarball":"https://registry.npmjs.org/@agentmark-ai/mcp-server/-/mcp-server-0.4.0.tgz","fileCount":8,"integrity":"sha512-rhnkai41uQvCDCV3wzCsm2DeEv69Ffa8qf2ezXu8729m8DZ9mJzSdeRgXwRTo7IhuFoiyufJYFb3RiP4fMhxnQ==","signatures":[{"sig":"MEQCIDrvKaaID0MNPEVRX7T2TKdLaptOZQjyZ6WFIlgHbUFhAiA+b1Dx1bcmQXz5FpV3HEkvatNd5Q90fj6kpuwa75Ybfw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":140468},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"6da6e2a0c5158be399ba1aa12077e153b2235208","scripts":{"dev":"tsup --config tsup.index.config.ts --watch","lint":"eslint .","test":"vitest run test/unit","build":"tsup --config tsup.index.config.ts && tsup --config tsup.bin.config.ts"},"_npmUser":{"name":"kashi11","email":"kashif.ali@carbonteq.com"},"_npmVersion":"10.9.8","description":"MCP server for AgentMark trace debugging","directories":{},"_nodeVersion":"22.22.3","dependencies":{"zod":"^3.25.0","@modelcontextprotocol/sdk":"^1.25.2"},"_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.5.1","eslint":"^9","vitest":"^4.1.8","cross-env":"^7.0.3","typescript":"^5","@types/node":"^20","@agentmark-ai/eslint-config":"*"},"_npmOperationalInternal":{"tmp":"tmp/mcp-server_0.4.0_1781197012910_0.6478832595814648","host":"s3://npm-registry-packages-npm-production"}},"0.4.1":{"name":"@agentmark-ai/mcp-server","version":"0.4.1","license":"AGPL-3.0-or-later","_id":"@agentmark-ai/mcp-server@0.4.1","maintainers":[{"name":"rrandall","email":"ryan@agentmark.co"},{"name":"kashi11","email":"kashif.ali@carbonteq.com"}],"bin":{"agentmark-mcp":"dist/bin.js"},"dist":{"shasum":"1ff71245d2a19e9e1ac4bc421bc3c318b5d986ca","tarball":"https://registry.npmjs.org/@agentmark-ai/mcp-server/-/mcp-server-0.4.1.tgz","fileCount":8,"integrity":"sha512-WxmgAw2CkMqpn2qCP9nDPYkd0xDwquFj1nzWwAr/R7tTbGUAxq7wDzJZa6N/9NiJjEaHxQZjMRaKxSLSAxLYVw==","signatures":[{"sig":"MEUCIQD5BTorwk/91orjG75Dop1qC8gI13QOMP2qMN4D01RCvQIgaREu6+iO2PX9YXQOYkK7ugpQwd73YzAsuv8JbCqR3J0=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":138616},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"aa24db338454e52a7aec105479699a8782de6820","mcpName":"io.github.agentmark-ai/mcp-server","scripts":{"dev":"tsup --config tsup.index.config.ts --watch","lint":"eslint .","test":"vitest run test/unit","build":"tsup --config tsup.index.config.ts && tsup --config tsup.bin.config.ts"},"_npmUser":{"name":"kashi11","email":"kashif.ali@carbonteq.com"},"_npmVersion":"10.9.8","description":"MCP server for AgentMark trace debugging","directories":{},"_nodeVersion":"22.22.3","dependencies":{"zod":"^3.25.0","@modelcontextprotocol/sdk":"^1.25.2"},"_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.5.1","eslint":"^9","vitest":"^4.1.8","cross-env":"^7.0.3","typescript":"^5","@types/node":"^20","@agentmark-ai/eslint-config":"*"},"_npmOperationalInternal":{"tmp":"tmp/mcp-server_0.4.1_1782223108368_0.08004544108152012","host":"s3://npm-registry-packages-npm-production"}},"0.4.2":{"name":"@agentmark-ai/mcp-server","version":"0.4.2","mcpName":"io.github.agentmark-ai/mcp-server","description":"MCP server for AgentMark trace debugging","type":"module","main":"./dist/index.js","types":"./dist/index.d.ts","bin":{"agentmark-mcp":"dist/bin.js"},"scripts":{"build":"tsup --config tsup.index.config.ts && tsup --config tsup.bin.config.ts","dev":"tsup --config tsup.index.config.ts --watch","lint":"eslint .","test":"vitest run test/unit"},"dependencies":{"@modelcontextprotocol/sdk":"^1.25.2","zod":"^3.25.0"},"devDependencies":{"@agentmark-ai/eslint-config":"*","@types/node":"^20","cross-env":"^7.0.3","eslint":"^9","tsup":"^8.5.1","typescript":"^5","vitest":"^4.1.8"},"license":"AGPL-3.0-or-later","engines":{"node":">=18.0.0"},"_id":"@agentmark-ai/mcp-server@0.4.2","gitHead":"4673082ce746f13a2e9362fa55f3cc431bb1edb5","_nodeVersion":"22.22.3","_npmVersion":"10.9.8","dist":{"integrity":"sha512-XPGDFuepM26cFjn7xQDHowj01Nm/Lt1IDXyKULUO6ROoKjd7IOWqkDoMiuN/cBGBoAiRrFoxCHs4DlPyQxfr3Q==","shasum":"59f8d6dc765ceaa9fd3b35315d8b8bc1237b1a1f","tarball":"https://registry.npmjs.org/@agentmark-ai/mcp-server/-/mcp-server-0.4.2.tgz","fileCount":8,"unpackedSize":138616,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIDEVhiJNIzlZEKFTbI1jZiihlw7gSVAU/v2b3iDxReV2AiEAjgolJHg8PiOVwcifEjIhQLNlWCYpcTgkikXUdXkskYQ="}]},"_npmUser":{"name":"kashi11","email":"kashif.ali@carbonteq.com"},"directories":{},"maintainers":[{"name":"rrandall","email":"ryan@agentmark.co"},{"name":"kashi11","email":"kashif.ali@carbonteq.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-server_0.4.2_1782225828116_0.37416837612206777"},"_hasShrinkwrap":false}},"time":{"created":"2026-01-19T09:28:01.466Z","modified":"2026-06-23T14:43:48.444Z","0.1.0":"2026-01-19T09:28:01.706Z","0.2.0":"2026-01-21T13:32:20.330Z","0.2.1":"2026-02-13T12:34:14.580Z","0.2.2":"2026-05-12T11:59:59.586Z","0.3.0":"2026-06-05T12:23:38.073Z","0.3.1":"2026-06-08T18:23:25.915Z","0.4.0":"2026-06-11T16:56:53.081Z","0.4.1":"2026-06-23T13:58:28.506Z","0.4.2":"2026-06-23T14:43:48.242Z"},"license":"AGPL-3.0-or-later","description":"MCP server for AgentMark trace debugging","maintainers":[{"name":"rrandall","email":"ryan@agentmark.co"},{"name":"kashi11","email":"kashif.ali@carbonteq.com"}],"readme":"# @agentmark-ai/mcp-server\n\nMCP (Model Context Protocol) server for [AgentMark](https://github.com/agentmark-ai/agentmark). Exposes the full AgentMark API to AI editors like Claude Code and Cursor: list traces and drill into spans, append dataset rows, write scores, run experiments, manage apps, deployments, environments, alerts, and annotation queues.\n\n## How it works\n\nThe server doesn't ship a fixed, hand-written tool list. On startup it reads the gateway's OpenAPI contract from `<AGENTMARK_API_URL>/v1/openapi.json` and registers **one MCP tool per endpoint** — tool names are the spec's operationIds in snake_case (`list_traces`, `get_trace`, `create_score`, `append_dataset_row`, `create_app`, ...). The tool surface always matches what the gateway actually accepts.\n\nBoth the local `agentmark dev` server and the Cloud gateway serve the same OpenAPI contract, so the same binary works against either — only the configured URL differs.\n\n## Usage\n\nRun it with `npx`; there's nothing to install. `npm create agentmark@latest` wires this up for you (as the `agentmark` and `agentmark-local` entries); the configs below are the manual equivalent.\n\n### Local dev server (Claude Code, Cursor, etc.)\n\nPoint at your running `agentmark dev` server. Add to `.mcp.json` (Claude Code), `.cursor/mcp.json` (Cursor), or your editor's MCP config:\n\n```json\n{\n  \"mcpServers\": {\n    \"agentmark-local\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@agentmark-ai/mcp-server\"],\n      \"env\": {\n        \"AGENTMARK_API_URL\": \"http://localhost:9418\"\n      }\n    }\n  }\n}\n```\n\nLocal calls are unauthenticated — no key needed.\n\n### AgentMark Cloud\n\nAfter `agentmark login`, no key is needed: the server resolves your session from `~/.agentmark/auth.json` and refreshes it automatically. For CI or agents without a login session, supply an API key (it takes precedence over the session):\n\n```json\n{\n  \"mcpServers\": {\n    \"agentmark\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@agentmark-ai/mcp-server\"],\n      \"env\": {\n        \"AGENTMARK_API_KEY\": \"your-api-key\"\n      }\n    }\n  }\n}\n```\n\n## Configuration\n\n| Environment Variable | Default | Description |\n|---------------------|---------|-------------|\n| `AGENTMARK_API_URL` | `https://api.agentmark.co` | Gateway URL; set to `http://localhost:9418` for the local dev server |\n| `AGENTMARK_API_KEY` | - | API key for Cloud authentication (optional after `agentmark login`; local dev is unauthenticated) |\n| `AGENTMARK_TIMEOUT_MS` | `30000` | Per-request timeout in milliseconds |\n\n## Requirements\n\nFor local development:\n\n1. The AgentMark CLI installed and running (`agentmark dev`)\n2. Traces recorded in your local AgentMark database\n\n## Programmatic Usage\n\n```typescript\nimport { createMCPServer, runServer } from '@agentmark-ai/mcp-server';\n\n// Run the server with stdio transport\nawait runServer();\n\n// Or create a server instance for custom transport\nconst server = await createMCPServer();\n```\n\n## Documentation\n\nFull reference at [docs.agentmark.co/reference/mcp-servers](https://docs.agentmark.co/reference/mcp-servers).\n\n## License\n\n[AGPL-3.0-or-later](../../LICENSE.md)\n","readmeFilename":"README.md"}