{"_id":"@agentkarma/mcp","name":"@agentkarma/mcp","dist-tags":{"latest":"0.1.0"},"versions":{"0.1.0":{"name":"@agentkarma/mcp","version":"0.1.0","description":"Turnkey MCP server for AgentKarma — the reputation layer for autonomous on-chain agents. stdio + HTTP. Run with `npx @agentkarma/mcp`.","license":"MIT","author":{"name":"Kerem Noras","email":"kerem@noras.tech"},"homepage":"https://agentkarma.io","repository":{"type":"git","url":"git+https://github.com/agentkarmaio/mcp.git"},"bugs":{"url":"https://github.com/agentkarmaio/mcp/issues"},"type":"module","main":"./dist/index.js","module":"./dist/index.js","types":"./dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"},"./package.json":"./package.json"},"bin":{"agentkarma-mcp":"dist/cli.js"},"sideEffects":false,"engines":{"node":">=18"},"publishConfig":{"access":"public"},"scripts":{"build":"tsc -p tsconfig.json && chmod +x dist/cli.js","typecheck":"tsc -p tsconfig.json --noEmit","test":"bun test","clean":"rm -rf dist","prepublishOnly":"bun run build","start":"bun run build && node ./dist/cli.js"},"keywords":["agentkarma","mcp","model-context-protocol","reputation","agents","trust","erc-8004","x402"],"dependencies":{"@agentkarma/sdk":"^0.2.0","@modelcontextprotocol/sdk":"^1.29.0"},"devDependencies":{"@types/node":"^22.0.0","bun-types":"^1.1.0","typescript":"^5.7.0"},"_id":"@agentkarma/mcp@0.1.0","gitHead":"89baa1be96f533f127ca31b0a4fb32d6dd8b74df","_nodeVersion":"22.19.0","_npmVersion":"10.9.3","dist":{"integrity":"sha512-ckBOEZuO8EKT8JZUhnFpDOlR5eXFYyIqqyozPS6dFA154eSFKa+zsqdkZdrb2VRSkmXVFYsd0p4uPpiLpEORcQ==","shasum":"5f2283159f7b19b1f27d52f5c7c2ad43bee2fe9d","tarball":"https://registry.npmjs.org/@agentkarma/mcp/-/mcp-0.1.0.tgz","fileCount":23,"unpackedSize":47496,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCICUFHuwf6eP9Qv32IsPy/jPTMacvDbaJiV1h/ykZUIe+AiA6IYzcMBYfLy6llBtaONaQj/MpyYIv42X7bW+s7eftqA=="}]},"_npmUser":{"name":"knrs","email":"kerem@noras.tech"},"directories":{},"maintainers":[{"name":"knrs","email":"kerem@noras.tech"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp_0.1.0_1782379030674_0.867067513364776"},"_hasShrinkwrap":false}},"time":{"created":"2026-06-25T09:17:10.544Z","0.1.0":"2026-06-25T09:17:10.814Z","modified":"2026-06-25T09:17:11.033Z"},"maintainers":[{"name":"knrs","email":"kerem@noras.tech"}],"description":"Turnkey MCP server for AgentKarma — the reputation layer for autonomous on-chain agents. stdio + HTTP. Run with `npx @agentkarma/mcp`.","homepage":"https://agentkarma.io","keywords":["agentkarma","mcp","model-context-protocol","reputation","agents","trust","erc-8004","x402"],"repository":{"type":"git","url":"git+https://github.com/agentkarmaio/mcp.git"},"author":{"name":"Kerem Noras","email":"kerem@noras.tech"},"bugs":{"url":"https://github.com/agentkarmaio/mcp/issues"},"license":"MIT","readme":"# @agentkarma/mcp\n\nTurnkey [MCP](https://modelcontextprotocol.io) server for [AgentKarma](https://agentkarma.io) — the reputation layer for autonomous on-chain agents.\n\nExpose AgentKarma's read surface (two-faced karma, ERC-8004 agents, succession/bond signals, and a local `check_trust` gate) to any MCP client — Claude Desktop, Cursor, Continue, …\n\n## Run it\n\n```sh\nnpx @agentkarma/mcp                       # stdio (default) — for Claude Desktop / Cursor\nnpx @agentkarma/mcp --http --port 8787    # HTTP streamable endpoint at /mcp\n```\n\nThat's the whole story — this package bundles `@agentkarma/sdk` and `@modelcontextprotocol/sdk` as regular dependencies, so there are no peer flags to remember.\n\n### Options\n\n```\n--http              Serve over HTTP instead of stdio (default: stdio)\n--port <n>          HTTP port (default 8787)\n--host <host>       HTTP host (default 127.0.0.1)\n--base-url <url>    AgentKarma API base (default https://agentkarma.io;\n                    also reads AGENTKARMA_BASE_URL)\n-v, --version       Print version\n-h, --help          Show help\n```\n\nThe HTTP server binds **loopback (`127.0.0.1`) by default** and enables DNS-rebinding\nprotection there. The endpoint is read-only and **unauthenticated** — binding a\nnon-loopback host (e.g. `--host 0.0.0.0`) exposes it to the network; put it behind\nyour own auth/proxy if you do.\n\n### Programmatic use\n\n```ts\nimport { startStdioServer, startHttpServer, createAgentKarmaMcpServer } from '@agentkarma/mcp';\n\nawait startStdioServer();                       // connect over stdio\nconst http = await startHttpServer({ port: 8787 }); // returns the http.Server\n```\n\n### Claude Desktop / Cursor config\n\n```json\n{\n  \"mcpServers\": {\n    \"agentkarma\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@agentkarma/mcp\"]\n    }\n  }\n}\n```\n\n## Tools (read-only)\n\n`get_karma` · `get_celo_agent` · `search_agents` · `get_agent_history` · `get_feedback_summary` · `get_succession` · `get_bond` · `get_surety` · `check_trust`\n\nEvery tool is read-only and needs no keys. AgentKarma is **non-routing** — it answers the trust question; it never signs, executes, or proxies a call.\n\n## Under the hood\n\nThis is a thin launcher over [`@agentkarma/sdk/mcp`](https://www.npmjs.com/package/@agentkarma/sdk). To embed the server in your own process, or to mount the framework-agnostic tool catalog (`@agentkarma/sdk/tools`) on an existing MCP server, use the SDK directly.\n\n## License\n\nMIT\n","readmeFilename":"README.md","_rev":"1-5e054dcb04324fa73b5a7ba81ae6ad55"}