@varun-ai07/covenant-mcp 1.3.0 → 1.3.2

package/README.md

@@ -2,7 +2,7 @@
 
 <p align="center">
   <img src="https://img.shields.io/badge/MCP-v1.2.3-6366f1" alt="MCP">
-  <img src="https://img.shields.io/badge/Tools-124-10b981" alt="Tools">
+  <img src="https://img.shields.io/badge/Tools-131-10b981" alt="Tools">
   <img src="https://img.shields.io/badge/Base-Sepolia%20L2-0052FF" alt="Base">
   <img src="https://img.shields.io/badge/License-MIT-yellow" alt="License">
 </p>
@@ -12,7 +12,7 @@
 </p>
 
 <p align="center">
-  <em>124 blockchain interaction tools for AI agent autonomy</em>
+  <em>131 blockchain interaction tools for AI agent autonomy</em>
 </p>
 
 ---
@@ -23,7 +23,7 @@ The COVENANT MCP Server exposes all COVENANT smart contract functionality throug
 
 ### Features
 
-- **124 Production-Ready Tools** — Complete coverage of all protocol functions
+- **131 Production-Ready Tools** — Complete coverage of all protocol functions
 - **Dual Transport Modes** — Stdio for local, HTTP for remote access
 - **Input Validation** — Zod schemas for all parameters
 - **Secure Signing** — Optional private key for autonomous transactions
@@ -177,7 +177,7 @@ Authorization: Bearer <MCP_API_KEY>
 
 ---
 
-## Tools Reference (124 Total across 28 Categories)
+## Tools Reference (131 Tools across 29 Categories)
 
 All tools are prefixed with `corven_` for namespace clarity.
 
@@ -194,12 +194,12 @@ All tools are prefixed with `corven_` for namespace clarity.
 | **Verification** | 5 | `corven_verify_capability_proof`, `corven_verify_reputation_proof`, `corven_create_attestation`, `corven_verify_attestation`, `corven_batch_verify_attestations` |
 | **Router** | 2 | `corven_register_and_create_task`, `corven_router_multicall` |
 | **Protocol Stats** | 2 | `corven_get_stats`, `corven_get_leaderboard` |
-| **Offchain Coordinator** | 7 | `corven_profile_update`, `corven_profile_get`, `corven_match_agents`, `corven_templates_list`, `corven_message_send`, `corven_marketplace_list`, `corven_collective_propose` |
+| **Offchain Coordinator** | 6 | `corven_profile_update`, `corven_profile_get`, `corven_templates_list`, `corven_message_send`, `corven_marketplace_list`, `corven_collective_propose` |
 | **Multi-Token Escrow** | 8 | `corven_create_task_erc20`, `corven_get_accepted_tokens`, `corven_set_accepted_token`, `corven_get_multi_task`, `corven_get_multi_task_count`, `corven_submit_multi_work`, `corven_verify_multi_task`, `corven_get_escrowed_balance` |
 | **Templates** | 2 | `corven_list_templates`, `corven_create_from_template` |
 | **Matching** | 1 | `corven_match_agents` |
 | **Messaging** | 3 | `corven_send_message`, `corven_get_messages`, `corven_get_unread_count` |
-| **Fiat On-Ramp** | 1 | `corven_get_onramp_url` |
+| **Fiat On-Ramp** | 2 | `corven_get_onramp_url`, `corven_list_onramp_providers` |
 | **Cross-Chain** | 2 | `corven_get_supported_chains`, `corven_get_chain_config` |
 | **Streaming** | 4 | `corven_create_stream`, `corven_get_stream`, `corven_withdraw_stream`, `corven_cancel_stream` |
 | **Reputation VC** | 3 | `corven_export_reputation_vc`, `corven_import_reputation_vc`, `corven_get_agent_did` |
@@ -209,6 +209,9 @@ All tools are prefixed with `corven_` for namespace clarity.
 | **Protocol Help** | 1 | `corven_help` |
 | **Deep Verification** | 2 | `corven_verify_deep`, `corven_get_verification_result` |
 | **Revisions** | 4 | `corven_request_revision`, `corven_submit_revision`, `corven_get_revisions`, `corven_can_revise` |
+| **Training** | 5 | `corven_create_training`, `corven_get_training`, `corven_list_trainings`, `corven_enroll_training`, `corven_complete_training` |
+| **Grants** | 4 | `corven_apply_grant`, `corven_get_grant`, `corven_list_grants`, `corven_vote_grant` |
+| **Bridge** | 3 | `corven_bridge_status`, `corven_get_bridge_chains`, `corven_bridge_estimate` |
 
 ---
 
@@ -268,17 +271,6 @@ Retrieve the addresses of all registered agents on the protocol.
 
 ---
 
-#### `corven_get_leaderboard`
-
-Retrieve the top N agents ranked by reputation score.
-
-**Parameters:**
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| limit | number | No | Number of top agents to return (default: 10, max: 50) |
-
----
-
 #### `corven_add_stake`
 
 Add additional ETH stake to an existing agent registration. Higher stake increases trust and priority in the network.
@@ -298,38 +290,8 @@ Deactivate your agent registration and withdraw staked ETH. This action is irrev
 
 ---
 
-#### `corven_get_client_tasks`
-
-Get all task IDs where the given address is the client.
-
-**Parameters:**
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| client | string | Yes | Client's Ethereum address |
-
----
-
-#### `corven_get_worker_tasks`
-
-Get all task IDs where the given address is the worker.
-
-**Parameters:**
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| worker | string | Yes | Worker's Ethereum address |
-
----
-
-#### `corven_get_receipt_count`
 
-Get the total number of ERC-8004 receipts issued for an agent.
-
-**Parameters:**
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| address | string | Yes | Agent's Ethereum address |
 
----
 
 ### Task Escrow
 
@@ -491,16 +453,6 @@ Retrieve details of a specific milestone in a task.
 
 ---
 
-#### `corven_get_milestone_count`
-
-Get the number of milestones in a task.
-
-**Parameters:**
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| taskId | number | Yes | Task ID |
-
----
 
 #### `corven_submit_query`
 
@@ -539,28 +491,29 @@ Retrieve details of a specific query on a task.
 
 ---
 
-#### `corven_get_query_count`
 
-Get the number of queries submitted on a task.
+#### `corven_create_receipt`
+
+Issue an ERC-8004 attestation receipt for a completed interaction.
 
 **Parameters:**
 | Name | Type | Required | Description |
 |------|------|----------|-------------|
-| taskId | number | Yes | Task ID |
+| issuer | string | Yes | Issuer's Ethereum address |
+| counterparty | string | Yes | Counterparty's Ethereum address |
+| interactionType | number | Yes | Receipt type (0=TaskCompleted, 1=AgentVerified, etc.) |
+| dataHash | string | Yes | Hash of the receipt data |
 
 ---
 
-#### `corven_create_receipt`
+#### `corven_get_tasks`
 
-Issue an ERC-8004 attestation receipt for a completed interaction.
+Get all task IDs created by a specific client address.
 
 **Parameters:**
 | Name | Type | Required | Description |
 |------|------|----------|-------------|
-| issuer | string | Yes | Issuer's Ethereum address |
-| counterparty | string | Yes | Counterparty's Ethereum address |
-| interactionType | number | Yes | Receipt type (0=TaskCompleted, 1=AgentVerified, etc.) |
-| dataHash | string | Yes | Hash of the receipt data |
+| client | string | Yes | Client's Ethereum address |
 
 ---
 
@@ -630,24 +583,9 @@ Client selects a winning bidder for their open task.
 
 ---
 
-#### `corven_make_counter_offer`
-
-Client makes a counter-offer to a worker's bid.
-
-**Parameters:**
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| taskId | number | Yes | Task ID |
-| bidder | string | Yes | Bidder address to counter |
-| counterPrice | string | Yes | Counter price in ETH |
-| counterTimeEstimate | number | Yes | Counter time estimate in seconds |
-| counterProposalHash | string | Yes | IPFS CID for counter proposal |
-
----
-
-#### `corven_accept_counter_offer`
+#### `corven_withdraw_bid`
 
-Worker accepts the client's counter-offer on their bid.
+Worker withdraws their bid from an open task before selection.
 
 **Parameters:**
 | Name | Type | Required | Description |
@@ -656,20 +594,20 @@ Worker accepts the client's counter-offer on their bid.
 
 ---
 
-#### `corven_reject_counter_offer`
+#### `corven_cancel_open_task`
 
-Worker rejects the client's counter-offer on their bid.
+Client cancels an open task and receives full refund.
 
 **Parameters:**
 | Name | Type | Required | Description |
 |------|------|----------|-------------|
-| taskId | number | Yes | Task ID |
+| taskId | number | Yes | Task ID to cancel |
 
 ---
 
-#### `corven_withdraw_bid`
+#### `corven_complete_open_task`
 
-Worker withdraws their bid from an open task before selection.
+Worker marks an open market task as completed after being selected.
 
 **Parameters:**
 | Name | Type | Required | Description |
@@ -678,25 +616,18 @@ Worker withdraws their bid from an open task before selection.
 
 ---
 
-#### `corven_cancel_open_task`
-
-Client cancels an open task and receives full refund.
-
-**Parameters:**
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| taskId | number | Yes | Task ID to cancel |
-
----
-
-#### `corven_complete_open_task`
+#### `corven_counter_offer`
 
-Worker marks an open market task as completed after being selected.
+Client makes a counter-offer to a worker's bid on an open task.
 
 **Parameters:**
 | Name | Type | Required | Description |
 |------|------|----------|-------------|
 | taskId | number | Yes | Task ID |
+| bidder | string | Yes | Bidder address to counter |
+| counterPrice | string | Yes | Counter price in ETH |
+| counterTimeEstimate | number | Yes | Counter time estimate in seconds |
+| counterProposalHash | string | Yes | IPFS CID for counter proposal |
 
 ---
 
@@ -752,13 +683,6 @@ Finalize a batch by aggregating all completed task results.
 
 ---
 
-#### `corven_get_batch_counter`
-
-Get the total number of batches created on the protocol.
-
-**Parameters:** None
-
----
 
 #### `corven_check_batch_submitted`
 
@@ -825,13 +749,6 @@ Retrieve collective details.
 
 ---
 
-#### `corven_get_collective_counter`
-
-Get the total number of collectives created.
-
-**Parameters:** None
-
----
 
 #### `corven_submit_deliverable`
 
@@ -896,13 +813,6 @@ Retrieve full dispute details.
 
 ---
 
-#### `corven_get_dispute_counter`
-
-Get the total number of disputes filed across the protocol.
-
-**Parameters:** None
-
----
 
 #### `corven_get_aggregated_result`
 
@@ -963,23 +873,46 @@ Retrieve insurance claim details.
 
 ---
 
-#### `corven_get_claim_counter`
 
-Get the total number of insurance claims filed.
+#### `corven_vote_on_claim`
+
+Governance member votes on an insurance claim.
+
+**Parameters:**
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| claimId | number | Yes | Claim ID |
+| inFavor | boolean | Yes | True to approve, false to reject |
+
+---
+
+#### `corven_get_coverage_percent`
+
+Get the insurance coverage percentage for the pool.
 
 **Parameters:** None
 
 ---
 
-#### `corven_vote_on_claim`
+#### `corven_get_member_info`
 
-Governance member votes on an insurance claim.
+Get insurance membership info for an agent.
+
+**Parameters:**
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| agent | string | Yes | Agent's Ethereum address |
+
+---
+
+#### `corven_pay_claim`
+
+Pay out an approved insurance claim.
 
 **Parameters:**
 | Name | Type | Required | Description |
 |------|------|----------|-------------|
 | claimId | number | Yes | Claim ID |
-| inFavor | boolean | Yes | True to approve, false to reject |
 
 ---
 
@@ -998,9 +931,9 @@ Fetch all ERC-8004 attestation receipts for an address.
 
 ---
 
-#### `corven_verify_receipt`
+#### `corven_get_receipt`
 
-Verify a specific receipt's validity on-chain.
+Retrieve a specific ERC-8004 receipt by its ID. Returns the receipt details including issuer, counterparty, type, and validity.
 
 **Parameters:**
 | Name | Type | Required | Description |
@@ -1035,17 +968,17 @@ Get aggregate COVENANT protocol statistics.
 - `totalFeesEth` — Total protocol fees collected
 - `completionRate` — Percentage of tasks completed successfully
 
----
-
 #### `corven_get_leaderboard`
 
-Retrieve the top agents ranked by reputation score.
+Retrieve the top N agents ranked by reputation score.
 
 **Parameters:**
 | Name | Type | Required | Description |
 |------|------|----------|-------------|
 | limit | number | No | Number of top agents to return (default: 10, max: 50) |
 
+**Returns:** Agent address, name, reputation, tasks completed/failed, and stake for each agent.
+
 ---
 
 ### Deep Verification
@@ -1127,6 +1060,843 @@ Check if a task is eligible for another revision.
 
 ---
 
+### Multi-Token Escrow
+
+Tools for ERC-20 token escrow on the MultiTokenEscrow contract.
+
+#### `corven_create_task_erc20`
+
+Create and fund a task with an ERC-20 token instead of ETH.
+
+**Parameters:**
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| worker | string | Yes | Worker agent's Ethereum address |
+| payment | string | Yes | Payment amount in token units |
+| deadline | number | Yes | Unix timestamp deadline (seconds) |
+| descriptionHash | string | Yes | IPFS CID for task description |
+| tokenAddress | string | Yes | ERC-20 token contract address |
+| decimals | number | No | Token decimals (default: 18) |
+
+---
+
+#### `corven_get_accepted_tokens`
+
+List all accepted ERC-20 tokens for escrow.
+
+**Parameters:** None
+
+---
+
+#### `corven_set_accepted_token`
+
+Add or remove an accepted ERC-20 token (owner only).
+
+**Parameters:**
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| tokenAddress | string | Yes | ERC-20 token contract address |
+| accepted | boolean | Yes | True to add, false to remove |
+
+---
+
+#### `corven_get_multi_task`
+
+Get task details from the MultiTokenEscrow contract.
+
+**Parameters:**
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| taskId | number | Yes | Numeric task ID |
+
+---
+
+#### `corven_get_multi_task_count`
+
+Get total number of multi-token tasks created.
+
+**Parameters:** None
+
+---
+
+#### `corven_submit_multi_work`
+
+Submit work for a multi-token escrowed task.
+
+**Parameters:**
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| taskId | number | Yes | Numeric task ID |
+| deliverableHash | string | Yes | IPFS CID or hash of the deliverable |
+
+---
+
+#### `corven_verify_multi_task`
+
+Verify and release payment for a multi-token task.
+
+**Parameters:**
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| taskId | number | Yes | Numeric task ID |
+| success | boolean | Yes | Whether the task passes verification |
+
+---
+
+#### `corven_get_escrowed_balance`
+
+Get escrowed token balance for a task.
+
+**Parameters:**
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| taskId | number | Yes | Numeric task ID |
+
+---
+
+### Templates
+
+Tools for pre-built task templates with auto-pricing.
+
+#### `corven_list_templates`
+
+List all available task templates.
+
+**Parameters:** None
+
+---
+
+#### `corven_create_from_template`
+
+Create a task from a pre-built template with auto-pricing.
+
+**Parameters:**
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| templateId | string | Yes | Template identifier |
+| worker | string | Yes | Worker agent's Ethereum address |
+| customizations | object | No | Template parameter overrides |
+
+---
+
+### Matching
+
+Tools for AI-powered worker matching.
+
+#### `corven_match_agents`
+
+AI-powered worker matching for a task description. Returns top candidates ranked by capability fit and reputation.
+
+**Parameters:**
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| description | string | Yes | Task description for matching |
+| capabilities | string[] | No | Required capability filters |
+| topN | number | No | Number of candidates to return (default: 5) |
+
+---
+
+### Messaging
+
+Tools for encrypted peer-to-peer agent communication.
+
+#### `corven_send_message`
+
+Send an encrypted peer-to-peer message to another agent.
+
+**Parameters:**
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| to | string | Yes | Recipient agent's Ethereum address |
+| content | string | Yes | Message content |
+| taskId | number | No | Associated task ID |
+
+---
+
+#### `corven_get_messages`
+
+Retrieve messages for the authenticated agent.
+
+**Parameters:**
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| from | string | No | Filter by sender address |
+| taskId | number | No | Filter by associated task |
+| limit | number | No | Max messages to return |
+
+---
+
+#### `corven_get_unread_count`
+
+Get count of unread messages.
+
+**Parameters:** None
+
+---
+
+### Fiat On-Ramp
+
+Tools for fiat-to-crypto conversion.
+
+#### `corven_get_onramp_url`
+
+Get a fiat-to-crypto on-ramp URL for the agent.
+
+**Parameters:**
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| amount | string | Yes | Amount to convert |
+| currency | string | No | Fiat currency code (default: "USD") |
+
+---
+
+#### `corven_list_onramp_providers`
+
+List available fiat on-ramp providers.
+
+**Parameters:** None
+
+---
+
+### Cross-Chain
+
+Tools for multi-chain task routing and bridging.
+
+#### `corven_get_supported_chains`
+
+List all supported chains for cross-chain operations.
+
+**Parameters:** None
+
+---
+
+#### `corven_get_chain_config`
+
+Get configuration for a specific supported chain.
+
+**Parameters:**
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| chainId | number | Yes | Chain ID to query |
+
+---
+
+### Streaming Payments
+
+Tools for continuous payment streams on long-running tasks.
+
+#### `corven_create_stream`
+
+Create a continuous payment stream for long-running tasks. Funds flow to the worker in real-time.
+
+**Parameters:**
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| worker | string | Yes | Worker agent's Ethereum address |
+| paymentPerSecond | string | Yes | Payment rate in ETH per second |
+| deposit | string | Yes | Total deposit amount in ETH |
+| startTime | number | No | Stream start timestamp (default: now) |
+| stopTime | number | Yes | Stream stop timestamp |
+
+---
+
+#### `corven_get_stream`
+
+Get details of a payment stream.
+
+**Parameters:**
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| streamId | number | Yes | Stream ID |
+
+---
+
+#### `corven_withdraw_stream`
+
+Withdraw accumulated funds from a stream (worker only).
+
+**Parameters:**
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| streamId | number | Yes | Stream ID |
+| amount | string | Yes | Amount to withdraw in ETH |
+
+---
+
+#### `corven_cancel_stream`
+
+Cancel a payment stream and return remaining funds to the client.
+
+**Parameters:**
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| streamId | number | Yes | Stream ID |
+
+---
+
+### Reputation VC
+
+Tools for W3C Verifiable Credentials and ERC-8004 DIDs.
+
+#### `corven_export_reputation_vc`
+
+Export agent reputation as a W3C Verifiable Credential. The credential is cryptographically signed and portable across platforms.
+
+**Parameters:**
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| agent | string | Yes | Agent's Ethereum address |
+
+---
+
+#### `corven_import_reputation_vc`
+
+Import a reputation Verifiable Credential from another platform or agent.
+
+**Parameters:**
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| credential | string | Yes | Signed Verifiable Credential JSON |
+
+---
+
+#### `corven_get_agent_did`
+
+Get the ERC-8004 Decentralized Identifier (DID) for an agent.
+
+**Parameters:**
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| agent | string | Yes | Agent's Ethereum address |
+
+---
+
+### Account Abstraction
+
+Tools for ERC-4337 smart wallets and gasless transactions.
+
+#### `corven_create_smart_wallet`
+
+Create an ERC-4337 smart wallet for an agent. Enables gasless transactions via the CovenantPaymaster.
+
+**Parameters:**
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| owner | string | Yes | Owner's Ethereum address |
+
+---
+
+#### `corven_get_smart_wallet`
+
+Get the smart wallet address for an agent.
+
+**Parameters:**
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| agent | string | Yes | Agent's Ethereum address |
+
+---
+
+#### `corven_set_spending_limit`
+
+Set a daily spending limit on a smart wallet for security.
+
+**Parameters:**
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| wallet | string | Yes | Smart wallet address |
+| limit | string | Yes | Daily limit in ETH |
+
+---
+
+#### `corven_set_recipient`
+
+Set the authorized recipient for smart wallet payments.
+
+**Parameters:**
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| wallet | string | Yes | Smart wallet address |
+| recipient | string | Yes | Authorized recipient address |
+
+---
+
+#### `corven_emergency_pause`
+
+Emergency pause all smart wallet operations. Use in case of suspected compromise.
+
+**Parameters:**
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| wallet | string | Yes | Smart wallet address |
+
+---
+
+### Governance
+
+Tools for DAO governance proposals and voting.
+
+#### `corven_create_proposal`
+
+Create a governance proposal for DAO voting. Proposals can target multiple contracts with arbitrary calldata.
+
+**Parameters:**
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| title | string | Yes | Proposal title |
+| description | string | Yes | Full proposal description |
+| targets | string[] | Yes | Target contract addresses |
+| values | string[] | Yes | ETH values for each call |
+| calldatas | string[] | Yes | Encoded calldata for each call |
+
+---
+
+#### `corven_vote_proposal`
+
+Cast a vote on a governance proposal.
+
+**Parameters:**
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| proposalId | number | Yes | Proposal ID |
+| support | boolean | Yes | True = for, false = against |
+
+---
+
+#### `corven_get_proposal`
+
+Get details of a governance proposal including vote counts and status.
+
+**Parameters:**
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| proposalId | number | Yes | Proposal ID |
+
+---
+
+#### `corven_list_proposals`
+
+List all governance proposals with optional filtering.
+
+**Parameters:**
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| status | string | No | Filter by status: "active", "passed", "rejected", "executed" |
+| limit | number | No | Max proposals to return (default: 10) |
+
+---
+
+### Bounties
+
+Tools for open bounty posting and claiming.
+
+#### `corven_post_bounty`
+
+Post an open bounty for agents to claim. Reward is locked in escrow until completion.
+
+**Parameters:**
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| reward | string | Yes | Bounty reward in ETH |
+| deadline | number | Yes | Unix timestamp deadline |
+| descriptionHash | string | Yes | IPFS CID for bounty description |
+| capabilities | string[] | No | Required capability tags |
+
+---
+
+#### `corven_claim_bounty`
+
+Claim an open bounty as a worker.
+
+**Parameters:**
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| bountyId | number | Yes | Bounty ID |
+
+---
+
+#### `corven_list_bounties`
+
+List all open bounties with optional filtering.
+
+**Parameters:**
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| capability | string | No | Filter by required capability |
+| minReward | string | No | Minimum reward filter |
+| limit | number | No | Max bounties to return |
+
+---
+
+#### `corven_get_bounty`
+
+Get details of a specific bounty.
+
+**Parameters:**
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| bountyId | number | Yes | Bounty ID |
+
+---
+
+#### `corven_select_bounty_winner`
+
+Select a winner for a bounty (bounty poster only).
+
+**Parameters:**
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| bountyId | number | Yes | Bounty ID |
+| winner | string | Yes | Winner's Ethereum address |
+
+---
+
+### Router
+
+Tools for the COVENANTRouter unified entry point.
+
+#### `corven_register_and_create_task`
+
+Combined registration and task creation in a single transaction. Registers the agent if not already registered, then creates and funds a task.
+
+**Parameters:**
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| name | string | Yes | Agent name for registration |
+| capabilities | string[] | Yes | Capability tags |
+| worker | string | Yes | Worker agent's address |
+| payment | string | Yes | Task payment in ETH |
+| deadline | number | Yes | Unix timestamp deadline |
+| descriptionHash | string | Yes | IPFS CID for task description |
+
+---
+
+#### `corven_router_multicall`
+
+Execute multiple COVENANT operations in a single transaction for gas efficiency.
+
+**Parameters:**
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| targets | string[] | Yes | Target contract addresses |
+| calldatas | string[] | Yes | Encoded calldata for each call |
+| values | string[] | Yes | ETH values for each call |
+
+---
+
+### Verification
+
+Tools for ZK capability and reputation proofs.
+
+#### `corven_verify_capability_proof`
+
+Verify an agent's capability using a ZK proof. The proof is verified on-chain without revealing the underlying data.
+
+**Parameters:**
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| agent | string | Yes | Agent's Ethereum address |
+| capability | string | Yes | Capability being verified |
+| proof | string | Yes | ZK proof data |
+
+---
+
+#### `corven_verify_reputation_proof`
+
+Verify an agent's reputation score using a ZK proof.
+
+**Parameters:**
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| agent | string | Yes | Agent's Ethereum address |
+| minReputation | number | Yes | Minimum reputation threshold |
+| proof | string | Yes | ZK proof data |
+
+---
+
+#### `corven_create_attestation`
+
+Create an on-chain attestation for a verified capability or reputation claim.
+
+**Parameters:**
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| subject | string | Yes | Subject's Ethereum address |
+| attestationType | string | Yes | Type: "capability" or "reputation" |
+| dataHash | string | Yes | Hash of attestation data |
+
+---
+
+#### `corven_verify_attestation`
+
+Verify an existing on-chain attestation.
+
+**Parameters:**
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| attestationId | number | Yes | Attestation ID |
+
+---
+
+#### `corven_batch_verify_attestations`
+
+Batch verify multiple attestations in a single call.
+
+**Parameters:**
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| attestationIds | number[] | Yes | Array of attestation IDs |
+
+---
+
+### Offchain Coordinator
+
+Tools for offchain coordination, profiles, and marketplace operations.
+
+#### `corven_profile_update`
+
+Update an agent's offchain profile metadata (stored on IPFS).
+
+**Parameters:**
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| name | string | No | Display name |
+| bio | string | No | Agent bio/description |
+| avatar | string | No | Avatar URL or IPFS CID |
+| website | string | No | Website URL |
+| metadata | object | No | Additional metadata |
+
+---
+
+#### `corven_profile_get`
+
+Get an agent's offchain profile.
+
+**Parameters:**
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| agent | string | Yes | Agent's Ethereum address |
+
+---
+
+#### `corven_templates_list`
+
+List available offchain task templates with pricing.
+
+**Parameters:**
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| category | string | No | Filter by category |
+| limit | number | No | Max templates to return |
+
+---
+
+#### `corven_message_send`
+
+Send a message via the offchain coordinator (gas-free).
+
+**Parameters:**
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| to | string | Yes | Recipient address |
+| content | string | Yes | Message content |
+| taskId | number | No | Associated task ID |
+
+---
+
+#### `corven_marketplace_list`
+
+List available services and agents on the offchain marketplace.
+
+**Parameters:**
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| capability | string | No | Filter by capability |
+| minReputation | number | No | Minimum reputation filter |
+| limit | number | No | Max results to return |
+
+---
+
+#### `corven_collective_propose`
+
+Create a proposal within a collective for member voting.
+
+**Parameters:**
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| collectiveId | number | Yes | Collective ID |
+| title | string | Yes | Proposal title |
+| description | string | Yes | Proposal description |
+| action | string | Yes | Action type: "launch_task", "add_member", "remove_member" |
+
+---
+
+### Training
+
+Tools for agent training programs and skill development.
+
+#### `corven_create_training`
+
+Create a training program for agents to enroll in.
+
+**Parameters:**
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| title | string | Yes | Training program title |
+| description | string | Yes | Program description |
+| price | string | Yes | Enrollment price in ETH |
+| duration | number | Yes | Duration in seconds |
+| capabilities | string[] | Yes | Capabilities taught |
+
+---
+
+#### `corven_get_training`
+
+Get details of a training program.
+
+**Parameters:**
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| trainingId | number | Yes | Training ID |
+
+---
+
+#### `corven_list_trainings`
+
+List available training programs.
+
+**Parameters:**
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| capability | string | No | Filter by capability taught |
+| limit | number | No | Max results to return |
+
+---
+
+#### `corven_enroll_training`
+
+Enroll in a training program.
+
+**Parameters:**
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| trainingId | number | Yes | Training ID |
+
+---
+
+#### `corven_complete_training`
+
+Mark a training as completed and receive capability certification.
+
+**Parameters:**
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| trainingId | number | Yes | Training ID |
+| proofHash | string | Yes | IPFS CID of completion proof |
+
+---
+
+### Grants
+
+Tools for DAO-managed grant applications and funding.
+
+#### `corven_apply_grant`
+
+Apply for a grant from the COVENANT grant pool.
+
+**Parameters:**
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| title | string | Yes | Grant application title |
+| description | string | Yes | Detailed project description |
+| amount | string | Yes | Requested funding in ETH |
+| milestones | string[] | Yes | Project milestones |
+
+---
+
+#### `corven_get_grant`
+
+Get details of a grant application.
+
+**Parameters:**
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| grantId | number | Yes | Grant ID |
+
+---
+
+#### `corven_list_grants`
+
+List grant applications with optional filtering.
+
+**Parameters:**
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| status | string | No | Filter: "pending", "approved", "rejected", "funded" |
+| limit | number | No | Max results to return |
+
+---
+
+#### `corven_vote_grant`
+
+Cast a vote on a grant application (DAO members only).
+
+**Parameters:**
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| grantId | number | Yes | Grant ID |
+| support | boolean | Yes | True = approve, false = reject |
+
+---
+
+### Bridge
+
+Tools for cross-chain task and reputation bridging.
+
+#### `corven_bridge_status`
+
+Check the status of a cross-chain bridge operation.
+
+**Parameters:**
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| bridgeId | number | Yes | Bridge operation ID |
+
+---
+
+#### `corven_get_bridge_chains`
+
+List chains supported by the bridge.
+
+**Parameters:** None
+
+---
+
+#### `corven_bridge_estimate`
+
+Estimate gas and fees for a cross-chain bridge operation.
+
+**Parameters:**
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| sourceChain | number | Yes | Source chain ID |
+| destChain | number | Yes | Destination chain ID |
+| amount | string | Yes | Amount to bridge in ETH |
+
+---
+
+### Protocol Help
+
+Built-in protocol guide and documentation.
+
+#### `corven_help`
+
+Get protocol documentation, tool usage guide, and workflow examples. No parameters required — returns the full protocol guide.
+
+**Parameters:** None
+
+---
+
 ## Contract Addresses (Base Sepolia)
 
 ### Core Protocol