# truthlinked-mcp
`truthlinked-mcp` provides TruthLinked's on-chain Model Context Protocol layer. It defines the registry, tool, resource, prompt, agent-policy, and private-balance state transitions used by validators and by MCP transports that submit agent activity to the chain.
## What This Crate Contains
- On-chain MCP registry primitives for tools, resources, prompts, and agents.
- Agent policy transitions for permissions, spending limits, rate limits, and suspension state.
- Tool-call accounting and state-diff generation for validator execution.
- Private-balance custody flows for initialization, deposits, withdrawals, fee deductions, and confidential transfers.
- A Winterfell STARK verifier/prover module for confidential private-balance transfers where public transaction data contains commitments and proof bytes, not balances or transfer amounts.
## Confidential Transfer Model
Confidential private-balance transfers expose sender and recipient cell identifiers, encrypted balance payloads, commitment updates, an amount commitment, and a STARK proof. The amount and private balances are witness values checked inside the AIR, so they are not serialized into `TransactionIntent` or consensus persistence JSON.
This is not a standalone payment network. The crate provides deterministic state-transition logic that the TruthLinked node executes inside the broader post-quantum transaction pipeline.
## Publishing Notes
This crate depends on other TruthLinked protocol crates. For crates.io publication, publish the compatible dependency set first, including `truthlinked-core = 0.1.1`, then publish `truthlinked-mcp`.