Klever MCP Server

{
  "type": "object",
  "properties": {
    "type": {
      "type": "string",
      "enum": [
        "code_example",
        "best_practice",
        "security_tip",
        "optimization",
        "documentation",
        "error_pattern",
        "deployment_tool",
        "runtime_behavior"
      ],
      "description": "The category of this knowledge entry. Choose the most specific type: \"code_example\" for Rust snippets, \"best_practice\" for recommended patterns, \"security_tip\" for vulnerability guidance, \"error_pattern\" for known error solutions."
    },
    "content": {
      "type": "string",
      "description": "The main content body — typically Rust source code, a CLI command, or a detailed explanation. For code, include the full working snippet."
    },
    "metadata": {
      "type": "object",
      "description": "Entry metadata including title, tags, and categorization. At minimum, provide a title.",
      "properties": {
        "title": {
          "type": "string",
          "description": "A concise, descriptive title (e.g. \"SingleValueMapper Storage Pattern\", \"KLV Payment Handling\")."
        },
        "description": {
          "type": "string",
          "description": "A 1-2 sentence summary of what this entry covers and when to use it."
        },
        "tags": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "Searchable tags for discovery (e.g. [\"storage\", \"mapper\", \"singlemapper\"], [\"tokens\", \"KLV\", \"payment\"]). Use lowercase."
        },
        "contractType": {
          "type": "string",
          "description": "The contract category this applies to (e.g. \"token\", \"nft\", \"defi\", \"dao\"). Omit if generally applicable."
        },
        "author": {
          "type": "string",
          "description": "Author name or identifier for attribution."
        }
      },
      "required": [
        "title"
      ]
    }
  },
  "required": [
    "type",
    "content",
    "metadata"
  ]
}

{
  "title": "Add Knowledge Entry",
  "readOnlyHint": false,
  "destructiveHint": false,
  "idempotentHint": false,
  "openWorldHint": false
}

{
  "type": "object",
  "properties": {
    "contractName": {
      "type": "string",
      "description": "The contract name to embed in scripts (e.g. \"my-token\"). If omitted, auto-detected from the `name` field in Cargo.toml."
    }
  }
}

{
  "title": "Add Helper Scripts",
  "readOnlyHint": false,
  "destructiveHint": false,
  "idempotentHint": true,
  "openWorldHint": false
}

{
  "type": "object",
  "properties": {
    "sourceCode": {
      "type": "string",
      "description": "The full Rust source code of the Klever smart contract to analyze. Must be valid Rust code using klever_sc imports."
    },
    "contractName": {
      "type": "string",
      "description": "Human-readable name for the contract (used in output labeling). Defaults to \"contract\" if omitted."
    }
  },
  "required": [
    "sourceCode"
  ]
}

{
  "title": "Analyze Contract",
  "readOnlyHint": true,
  "destructiveHint": false,
  "idempotentHint": true,
  "openWorldHint": false
}

{
  "type": "object",
  "properties": {}
}

{
  "title": "Check SDK Status",
  "readOnlyHint": true,
  "destructiveHint": false,
  "idempotentHint": true,
  "openWorldHint": false
}

{
  "type": "object",
  "properties": {
    "sender": {
      "type": "string",
      "description": "Deployer address (klv1... bech32 format)."
    },
    "wasmPath": {
      "type": "string",
      "description": "Absolute path to the compiled WASM file (preferred over wasmHex to avoid loading large binaries into AI context)."
    },
    "wasmHex": {
      "type": "string",
      "description": "Smart contract WASM bytecode as a hex-encoded string. Use wasmPath instead for large contracts."
    },
    "initArgs": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Optional base64-encoded init arguments for the contract constructor."
    },
    "network": {
      "type": "string",
      "enum": [
        "mainnet",
        "testnet",
        "devnet",
        "local"
      ],
      "description": "Network to use. Options: \"mainnet\", \"testnet\", \"devnet\", \"local\". Defaults to server default (mainnet)."
    }
  },
  "required": [
    "sender"
  ]
}

{
  "title": "Build Deploy SC Transaction",
  "readOnlyHint": false,
  "destructiveHint": false,
  "idempotentHint": false,
  "openWorldHint": true
}

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "The user's natural-language question or prompt to enhance (e.g. \"How do I handle KLV payments in my contract?\")."
    },
    "autoInclude": {
      "type": "boolean",
      "default": true,
      "description": "When true (default), automatically appends the most relevant knowledge base entries to the response. Set to false to only return metadata without injecting context."
    }
  },
  "required": [
    "query"
  ]
}

{
  "title": "Enhance Query with Context",
  "readOnlyHint": true,
  "destructiveHint": false,
  "idempotentHint": true,
  "openWorldHint": false
}

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "The context ID to find similar entries for. Obtain from query_context or get_context results."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "default": 5,
      "description": "Maximum number of similar entries to return. Typical range is 1-20; higher values may be slower. Default: 5."
    }
  },
  "required": [
    "id"
  ]
}

{
  "title": "Find Similar Contexts",
  "readOnlyHint": true,
  "destructiveHint": false,
  "idempotentHint": true,
  "openWorldHint": false
}

{
  "type": "object",
  "properties": {
    "sender": {
      "type": "string",
      "description": "Address to freeze from (klv1... bech32 format)."
    },
    "amount": {
      "type": "integer",
      "minimum": 1,
      "description": "Amount of KLV to freeze in the smallest unit (1 KLV = 1,000,000 units)."
    },
    "network": {
      "type": "string",
      "enum": [
        "mainnet",
        "testnet",
        "devnet",
        "local"
      ],
      "description": "Network to use. Options: \"mainnet\", \"testnet\", \"devnet\", \"local\". Defaults to server default (mainnet)."
    }
  },
  "required": [
    "sender",
    "amount"
  ]
}

{
  "title": "Build Freeze KLV Transaction",
  "readOnlyHint": false,
  "destructiveHint": false,
  "idempotentHint": false,
  "openWorldHint": true
}

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string",
      "description": "Klever address (klv1... bech32 format)."
    },
    "network": {
      "type": "string",
      "enum": [
        "mainnet",
        "testnet",
        "devnet",
        "local"
      ],
      "description": "Network to query. Options: \"mainnet\", \"testnet\", \"devnet\", \"local\". Defaults to server default (mainnet)."
    }
  },
  "required": [
    "address"
  ]
}

{
  "title": "Get Account",
  "readOnlyHint": true,
  "destructiveHint": false,
  "idempotentHint": true,
  "openWorldHint": true
}

{
  "type": "object",
  "properties": {
    "assetId": {
      "type": "string",
      "description": "Asset identifier (e.g. \"KLV\", \"KFI\", \"USDT-A1B2\", \"MYNFT-XY78\")."
    },
    "network": {
      "type": "string",
      "enum": [
        "mainnet",
        "testnet",
        "devnet",
        "local"
      ],
      "description": "Network to query. Options: \"mainnet\", \"testnet\", \"devnet\", \"local\". Defaults to server default (mainnet)."
    }
  },
  "required": [
    "assetId"
  ]
}

{
  "title": "Get Asset Info",
  "readOnlyHint": true,
  "destructiveHint": false,
  "idempotentHint": true,
  "openWorldHint": true
}

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string",
      "description": "Klever address (klv1... bech32 format)."
    },
    "assetId": {
      "type": "string",
      "description": "Optional KDA token ID (e.g. \"USDT-A1B2\", \"LPKLVKFI-3I0N\"). Omit for KLV balance."
    },
    "network": {
      "type": "string",
      "enum": [
        "mainnet",
        "testnet",
        "devnet",
        "local"
      ],
      "description": "Network to query. Options: \"mainnet\", \"testnet\", \"devnet\", \"local\". Defaults to server default (mainnet)."
    }
  },
  "required": [
    "address"
  ]
}

{
  "title": "Get Balance",
  "readOnlyHint": true,
  "destructiveHint": false,
  "idempotentHint": true,
  "openWorldHint": true
}

{
  "type": "object",
  "properties": {
    "nonce": {
      "type": "integer",
      "minimum": 0,
      "description": "Block number (nonce). Omit to get the latest block."
    },
    "network": {
      "type": "string",
      "enum": [
        "mainnet",
        "testnet",
        "devnet",
        "local"
      ],
      "description": "Network to query. Options: \"mainnet\", \"testnet\", \"devnet\", \"local\". Defaults to server default (mainnet)."
    }
  }
}

{
  "title": "Get Block",
  "readOnlyHint": true,
  "destructiveHint": false,
  "idempotentHint": true,
  "openWorldHint": true
}

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "The unique context ID (UUID format). Obtain IDs from query_context or find_similar results."
    }
  },
  "required": [
    "id"
  ]
}

{
  "title": "Get Context by ID",
  "readOnlyHint": true,
  "destructiveHint": false,
  "idempotentHint": true,
  "openWorldHint": false
}

{
  "type": "object",
  "properties": {}
}

{
  "title": "Knowledge Base Stats",
  "readOnlyHint": true,
  "destructiveHint": false,
  "idempotentHint": true,
  "openWorldHint": false
}

{
  "type": "object",
  "properties": {
    "hash": {
      "type": "string",
      "description": "Transaction hash (hex string)."
    },
    "network": {
      "type": "string",
      "enum": [
        "mainnet",
        "testnet",
        "devnet",
        "local"
      ],
      "description": "Network to query. Options: \"mainnet\", \"testnet\", \"devnet\", \"local\". Defaults to server default (mainnet)."
    }
  },
  "required": [
    "hash"
  ]
}

{
  "title": "Get Transaction",
  "readOnlyHint": true,
  "destructiveHint": false,
  "idempotentHint": true,
  "openWorldHint": true
}

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "The contract project name in kebab-case (e.g. \"my-token\", \"nft-marketplace\"). Used as the Cargo package name and directory name."
    },
    "template": {
      "type": "string",
      "enum": [
        "empty",
        "adder"
      ],
      "description": "Project template to scaffold from. \"empty\" creates a blank contract with just an init function. \"adder\" creates a simple counter example. Default: \"empty\".",
      "default": "empty"
    },
    "noMove": {
      "type": "boolean",
      "description": "When true, keeps the project in the SDK output directory instead of moving it to the current working directory. Default: false.",
      "default": false
    }
  },
  "required": [
    "name"
  ]
}

{
  "title": "Initialize Klever Project",
  "readOnlyHint": false,
  "destructiveHint": false,
  "idempotentHint": false,
  "openWorldHint": false
}

{
  "type": "object",
  "properties": {
    "tool": {
      "type": "string",
      "enum": [
        "ksc",
        "koperator",
        "all"
      ],
      "description": "Which SDK component to install. \"ksc\" = smart contract compiler only, \"koperator\" = blockchain operator CLI + VM library, \"all\" = both ksc and koperator. Default: \"all\".",
      "default": "all"
    }
  }
}

{
  "title": "Install Klever SDK",
  "readOnlyHint": false,
  "destructiveHint": false,
  "idempotentHint": true,
  "openWorldHint": true
}

{
  "type": "object",
  "properties": {
    "sender": {
      "type": "string",
      "description": "Caller address (klv1... bech32 format)."
    },
    "scAddress": {
      "type": "string",
      "description": "Smart contract address (klv1... bech32 format)."
    },
    "funcName": {
      "type": "string",
      "description": "Endpoint function name to invoke."
    },
    "args": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Optional base64-encoded arguments."
    },
    "callValue": {
      "type": "object",
      "additionalProperties": {
        "type": "integer"
      },
      "description": "Optional token amounts to send with the call, as a map of token ID to amount (e.g. {\"KLV\": 1000000}). Required for payable endpoints."
    },
    "network": {
      "type": "string",
      "enum": [
        "mainnet",
        "testnet",
        "devnet",
        "local"
      ],
      "description": "Network to use. Options: \"mainnet\", \"testnet\", \"devnet\", \"local\". Defaults to server default (mainnet)."
    }
  },
  "required": [
    "sender",
    "scAddress",
    "funcName"
  ]
}

{
  "title": "Build Invoke SC Transaction",
  "readOnlyHint": false,
  "destructiveHint": false,
  "idempotentHint": false,
  "openWorldHint": true
}

{
  "type": "object",
  "properties": {
    "network": {
      "type": "string",
      "enum": [
        "mainnet",
        "testnet",
        "devnet",
        "local"
      ],
      "description": "Network to query. Options: \"mainnet\", \"testnet\", \"devnet\", \"local\". Defaults to server default (mainnet)."
    }
  }
}

{
  "title": "List Validators",
  "readOnlyHint": true,
  "destructiveHint": false,
  "idempotentHint": true,
  "openWorldHint": true
}

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Free-text search query. Use Klever-specific terms for best results (e.g. \"storage mapper SingleValueMapper\", \"payable endpoint KLV\", \"deploy contract testnet\")."
    },
    "types": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "code_example",
          "best_practice",
          "security_tip",
          "optimization",
          "documentation",
          "error_pattern",
          "deployment_tool",
          "runtime_behavior"
        ]
      },
      "description": "Filter results by context type. Omit to search all types. Common combinations: [\"code_example\", \"documentation\"] for learning, [\"error_pattern\"] for debugging, [\"security_tip\", \"best_practice\"] for reviews."
    },
    "tags": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Filter by tags (e.g. [\"storage\", \"mapper\"], [\"tokens\", \"KLV\"], [\"events\"]). Tags are matched with OR logic — any matching tag includes the entry."
    },
    "contractType": {
      "type": "string",
      "description": "Filter by contract type (e.g. \"token\", \"nft\", \"defi\", \"dao\"). Only returns entries tagged for this contract category."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "default": 10,
      "description": "Maximum number of results to return (1-100). Default: 10."
    },
    "offset": {
      "type": "integer",
      "minimum": 0,
      "default": 0,
      "description": "Number of results to skip for pagination. Use with limit to page through results. Default: 0."
    }
  }
}

{
  "title": "Query Knowledge Base",
  "readOnlyHint": true,
  "destructiveHint": false,
  "idempotentHint": true,
  "openWorldHint": false
}

{
  "type": "object",
  "properties": {
    "scAddress": {
      "type": "string",
      "description": "Smart contract address (klv1... bech32 format)."
    },
    "funcName": {
      "type": "string",
      "description": "Function name to call (must be a #[view] function on the contract)."
    },
    "args": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Optional base64-encoded arguments. For addresses, encode the hex-decoded bech32 bytes. For numbers, use big-endian byte encoding."
    },
    "caller": {
      "type": "string",
      "description": "Optional caller address (klv1... bech32 format). Some view functions use the caller to look up address-keyed storage mappers."
    },
    "network": {
      "type": "string",
      "enum": [
        "mainnet",
        "testnet",
        "devnet",
        "local"
      ],
      "description": "Network to query. Options: \"mainnet\", \"testnet\", \"devnet\", \"local\". Defaults to server default (mainnet)."
    }
  },
  "required": [
    "scAddress",
    "funcName"
  ]
}

{
  "title": "Query Smart Contract",
  "readOnlyHint": true,
  "destructiveHint": false,
  "idempotentHint": true,
  "openWorldHint": true
}

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Search query in natural language (e.g. \"how to use storage mappers\", \"deploy contract to testnet\", \"handle KDA token transfers\")."
    },
    "category": {
      "type": "string",
      "enum": [
        "core",
        "storage",
        "events",
        "tokens",
        "modules",
        "tools",
        "scripts",
        "examples",
        "errors",
        "best-practices",
        "documentation"
      ],
      "description": "Narrow results to a specific knowledge category. Available: core, storage, events, tokens, modules, tools, scripts, examples, errors, best-practices, documentation."
    }
  },
  "required": [
    "query"
  ]
}

{
  "title": "Search Documentation",
  "readOnlyHint": true,
  "destructiveHint": false,
  "idempotentHint": true,
  "openWorldHint": false
}

{
  "type": "object",
  "properties": {
    "sender": {
      "type": "string",
      "description": "Sender address (klv1... bech32 format)."
    },
    "receiver": {
      "type": "string",
      "description": "Receiver address (klv1... bech32 format)."
    },
    "amount": {
      "type": "integer",
      "minimum": 1,
      "description": "Amount in the smallest unit. For KLV: 1 KLV = 1,000,000 units (6 decimals). Example: to send 10 KLV, use 10000000."
    },
    "assetId": {
      "type": "string",
      "description": "Optional KDA token ID for non-KLV transfers (e.g. \"USDT-A1B2\"). Omit for KLV."
    },
    "network": {
      "type": "string",
      "enum": [
        "mainnet",
        "testnet",
        "devnet",
        "local"
      ],
      "description": "Network to use. Options: \"mainnet\", \"testnet\", \"devnet\", \"local\". Defaults to server default (mainnet)."
    }
  },
  "required": [
    "sender",
    "receiver",
    "amount"
  ]
}

{
  "title": "Build Transfer Transaction",
  "readOnlyHint": false,
  "destructiveHint": false,
  "idempotentHint": false,
  "openWorldHint": true
}