write_kv_value

Instructions

Implementation Reference

• src/cloudflare_mcp_server/__init__.py:575-599 (handler)

  The actual implementation of the 'write_kv_value' tool. It writes a key-value pair to Cloudflare Workers KV storage by making a PUT request to the Cloudflare API. Supports optional expiration_ttl and metadata parameters.

  async def _write_kv_value(self, args: dict) -> str:
      """Write KV value."""
      account_id = args.get("account_id") or self.account_id
      if not account_id:
          raise ValueError("Account ID is required. Provide it in args or config.")
  
      url = f"{CLOUDFLARE_API_BASE}/accounts/{account_id}/storage/kv/namespaces/{args['namespace_id']}/values/{args['key']}"
  
      params = {}
      if args.get("expiration_ttl"):
          params["expiration_ttl"] = args["expiration_ttl"]
      if args.get("metadata"):
          params["metadata"] = json.dumps(args["metadata"])
  
      headers = {
          "Authorization": f"Bearer {self.api_token}",
          "Content-Type": "text/plain",
      }
  
      response = await self.client.put(
          url, content=args["value"], params=params, headers=headers
      )
      response.raise_for_status()
  
      return "KV value written successfully"

• src/cloudflare_mcp_server/__init__.py:304-331 (schema)

  The input schema definition for the 'write_kv_value' tool. Defines required parameters (namespace_id, key, value) and optional parameters (account_id, expiration_ttl, metadata).

  Tool(
      name="write_kv_value",
      description="Write a key-value pair to Workers KV storage. Can store text or metadata.",
      inputSchema={
          "type": "object",
          "properties": {
              "account_id": {
                  "type": "string",
                  "description": "Account ID (uses default from config if not provided)",
              },
              "namespace_id": {
                  "type": "string",
                  "description": "The KV namespace ID",
              },
              "key": {"type": "string", "description": "The key to write"},
              "value": {"type": "string", "description": "The value to store"},
              "expiration_ttl": {
                  "type": "number",
                  "description": "Number of seconds for the key to expire",
              },
              "metadata": {
                  "type": "object",
                  "description": "Arbitrary JSON metadata to store with the key",
              },
          },
          "required": ["namespace_id", "key", "value"],
      },
  ),

• src/cloudflare_mcp_server/__init__.py:424-425 (registration)

  Registration of the 'write_kv_value' tool in the call_tool handler. Routes the tool name to the '_write_kv_value' method.

  elif name == "write_kv_value":
      result = await self._write_kv_value(arguments)