{"schemaVersion":"tokensand-agent-pack-v1","version":"2026-06-12","name":"tokens& Agent Pack","description":"Installable context for coding agents that need AI/devtool stack decisions, builder offers, usage receipts, enterprise session analysis, Build Packets, and proof workflow guidance.","installPage":"https://tokensand.com/agents/install","codexPluginPath":"plugins/tokensand-agent-pack","codexMarketplacePath":".agents/plugins/marketplace.json","cursorPluginPath":"plugins/tokensand-cursor-plugin","cursorMarketplacePath":".cursor-plugin/marketplace.json","cursorInstallLink":"cursor://anysphere.cursor-deeplink/mcp/install?name=tokensand&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBkZXYtYWRvcHRpb24vY2xpQDAuMS4xMCIsIm1jcCIsInNlcnZlIiwiLS1hcGkiLCJodHRwczovL3Rva2Vuc2FuZC5jb20iXX0%3D","skills":{"tokensandAgentPack":{"name":"tokensand-agent-pack","url":"https://tokensand.com/agents/install/SKILL.md","localPaths":["plugins/tokensand-agent-pack/skills/tokensand-agent-pack/SKILL.md","plugins/tokensand-cursor-plugin/skills/tokensand-agent-pack/SKILL.md"],"installTargets":["codex","cursor","claude-code","vscode"],"purpose":"Portable instructions for agents to use Tokens& stack search, perks, Build Packets, Agent Skill publishing, usage receipts, and enterprise adoption briefs."}},"npm":{"packageName":"@dev-adoption/cli","packageSpec":"@dev-adoption/cli@0.1.10","latestPackageSpec":"@dev-adoption/cli@latest","version":"0.1.10","installCommand":"npm install -g @dev-adoption/cli@0.1.10","mcpCommand":"npx -y @dev-adoption/cli@0.1.10 mcp serve --api https://tokensand.com","publishCommand":"cd packages/cli && npm publish --access public"},"codex":{"addCommand":"codex mcp add tokensand -- npx -y @dev-adoption/cli@latest mcp serve --api https://tokensand.com","listCommand":"codex mcp list","restartNote":"Start a new Codex session after adding the MCP server so native Tokens& tools are loaded."},"claudeCode":{"addCommand":"claude mcp add --transport stdio tokensand -- npx -y @dev-adoption/cli@0.1.10 mcp serve --api https://tokensand.com","addJsonCommand":"claude mcp add-json tokensand '{\"type\":\"stdio\",\"command\":\"npx\",\"args\":[\"-y\",\"@dev-adoption/cli@0.1.10\",\"mcp\",\"serve\",\"--api\",\"https://tokensand.com\"],\"env\":{}}'"},"cliPackageSpec":"@dev-adoption/cli@0.1.10","mcpServer":{"name":"tokensand","command":"npx","args":["-y","@dev-adoption/cli@0.1.10","mcp","serve","--api","https://tokensand.com"],"optionalEnv":["DAI_TOKEN","DAI_AGENT_INSTALL_SESSION","DAI_MODE","DAI_ORGANIZATION_ID","DAI_ENTERPRISE_PROFILE","DAI_ENTERPRISE_TOKEN"],"publicTools":["get_account_mode","search_tools","find_perks","get_adoption_rank","build_brief","enterprise_session_brief"],"privateTools":["get_context","get_build_packet","publish_agent_skill","draft_project","publish_project"],"enterpriseTools":["get_account_mode","enterprise_session_brief","draft_enterprise_session_motion","draft_adoption_session","draft_builder_invite_motion","draft_icp_invite_batch","draft_partner_onboarding_motion","draft_partner_invite","draft_adoption_proof_motion"],"configEndpoint":"https://tokensand.com/api/workflow/mcp-config","auth":"The MCP server starts without auth for public stack search, perks, adoption rank, builder briefs with API/cost/credit guidance, and sample/user-supplied enterprise session briefs. Signed-in builders add DAI_TOKEN for saved stack, Build Packet, and project proof context. Enterprise live tenant metrics require explicit enterprise-scoped credentials; browser login is not inherited by Codex/Cursor."},"discovery":{"openapi":"https://tokensand.com/openapi.json","directoryContext":"https://tokensand.com/api/directory/context","aiPluginManifest":"https://tokensand.com/.well-known/ai-plugin.json","llms":"https://tokensand.com/llms.txt","fullLlms":"https://tokensand.com/llms-full.txt","skillMarkdown":"https://tokensand.com/agents/install/SKILL.md","integrationGuide":"https://tokensand.com/docs/api#integration-quickstart","usageReceiptsGuide":"https://tokensand.com/docs/api#usage-receipts","agentSkillImportGuide":"https://tokensand.com/docs/api#integration-quickstart","publicPerks":"https://tokensand.com/perks?public=1","builderWorkbench":"https://tokensand.com/tools?mode=build"},"examples":{"publicMcpCommand":"npx -y @dev-adoption/cli@0.1.10 mcp serve --api https://tokensand.com","privateBuilderMcpCommand":"DAI_AGENT_INSTALL_SESSION=dai_xxx npx -y @dev-adoption/cli@0.1.10 mcp serve --api https://tokensand.com","buildBriefPrompt":"Use Tokens& build_brief for a support agent with auth, memory, RAG over company docs, and deployment this week. Return tools, MCP servers, credits/perks, cost risks, Build Packet steps, and proof path.","agentSkillImportUrl":"https://tokensand.com/dashboard/agents?mode=developer&create=agent-skill&skillUrl=<encoded-public-skill-md-url>","agentSkillWorkflowApi":"https://tokensand.com/api/workflow/agent-skills","agentSkillPrompt":"Publish this SKILL.md to Tokens&: first call publish_agent_skill with skillUrl, review the draft, then call publish_agent_skill with confirm: true to create the dashboard draft.","usageReceiptRule":"Use @tokensand/adoption trackUsageReceipt server-side for model calls, MCP tool calls, API calls, spend, latency, and workflow outcomes. Never send raw prompts, secrets, private payloads, or source code."},"installTargets":[{"key":"codex","name":"Codex","status":"plugin-ready","setup":"Install the Tokens& Codex plugin for public stack search and enterprise session briefs, then add scoped credentials when private project or workspace context is needed.","primaryUse":"Bring Build Packets, saved stack context, enterprise session analysis, perks, and proof workflow guidance into Codex."},{"key":"cursor","name":"Cursor","status":"mcp-ready","setup":"Open the installer for public stack search and enterprise session briefs. Add a scoped workflow token later for private Build Packets and project proof.","primaryUse":"Let Cursor ask for Tokens& builder or enterprise context before implementation, session follow-up, and proof publishing."},{"key":"claude-code","name":"Claude Code","status":"mcp-ready","setup":"Use the same Tokens& MCP server command. Add DAI_TOKEN only when private project context is required.","primaryUse":"Give Claude Code the selected stack, cost, safety, docs, and proof plan without copying website text."},{"key":"npm","name":"npm","status":"publish-ready","setup":"Publish the CLI package publicly, then use the npm package name instead of the hosted tarball in every MCP config.","primaryUse":"Give every agent host one stable package specifier and avoid cache misses from versioned tarball URLs."},{"key":"vscode","name":"VS Code","status":"mcp-ready","setup":"Use the Codex IDE extension or a compatible MCP client. Public search works first; scoped tokens unlock project context.","primaryUse":"Keep stack decisions and project proof visible beside the repo."}],"workflows":[{"id":"choose_stack","label":"Choose the stack","agentInstruction":"Ask Tokens& search_tools or build_brief before code changes when the user is choosing tools, backend, auth, data, deployment, cost, credits, APIs, or proof path. Require live directory rows, DB facets, tracked actions, and a receipt ID for agent-context answers.","endpoints":["/api/directory/context","/api/workflow/build-packet","/api/build/search","/api/perks"]},{"id":"claim_offer","label":"Find useful builder offers","agentInstruction":"Check public perks and credits that match the selected stack. Do not imply a perk is guaranteed until the user claims it.","endpoints":["/api/perks"]},{"id":"publish_agent_skill","label":"Ship an Agent Skill","agentInstruction":"When the repo contains a public SKILL.md or the user gives a SKILL.md URL, call publish_agent_skill without confirm first. Review the parsed draft with the user, then call it again with confirm: true to create the private dashboard draft in Tokens&. Public publishing is a separate authenticated dashboard action after the install path is verified.","endpoints":["/api/workflow/agent-skills","/api/agents/skill-prefill","/dashboard/agents?mode=developer&create=agent-skill"]},{"id":"publish_proof","label":"Publish proof only after review","agentInstruction":"Draft repo, demo, stack, launch source, and notes first. Public proof publishing requires explicit human approval.","endpoints":["/api/workflow/context","/api/workflow/build-packet","/api/workflow/projects"]},{"id":"record_usage_receipt","label":"Record usage receipts","agentInstruction":"When a builder adds server-side instrumentation, use @tokensand/adoption trackUsageReceipt for model, MCP, API, spend, latency, and workflow proof. Keep tracking keys server-side and never include raw prompts, secrets, private payloads, or source code in receipt metadata.","endpoints":["/api/usage/track/dry-run","/api/usage/track","/docs/api#usage-receipts"]},{"id":"enterprise_signal","label":"Return enterprise session signal","agentInstruction":"Use get_account_mode first, then call enterprise_session_brief for source-labeled funnel rates, costs, ICP segment guidance, session format, dashboard handoff, and proof boundaries. Self-reported proof is not verified until first-party, public-source, consented, or aggregate-safe evidence clears the gate.","endpoints":["/api/v1/adoption","/api/v1/agent-rank","/api/usage/track/dry-run","mcp:enterprise_session_brief"]},{"id":"enterprise_motion","label":"Draft adoption motion","agentInstruction":"Draft the adoption session, ICP invite batch, Invite partner company motion, or proof plan inside the agent. For sessions, accept sourceProvider luma/partiful/eventbrite/zoom/manual plus a public sourceUrl, never API keys. Require dashboard approval before any Tokens& write or external send.","endpoints":["mcp:draft_adoption_session","mcp:draft_icp_invite_batch","mcp:draft_partner_invite","mcp:draft_adoption_proof_motion"]}],"safety":{"privacyBoundary":"Private saved stacks, project context, live enterprise tenant metrics, and write actions require a signed-in session or scoped workflow token.","approvalBoundary":"Tokens& creates tracking, partner intake, ICP preview, and proof. It does not create Luma/Zoom/Eventbrite pages or send external invites without approval.","dataBoundary":"Public adoption reads are aggregate and source-labeled; raw developer identity and tenant-scoped enterprise metrics stay private."},"moatStrengthens":["workflow_lock_in","proprietary_data_loop","distribution_leverage","switching_costs"]}