docs: update readme

Author: gzuuus

README.md

@@ -1,27 +1,66 @@
 # DVMCP: Data Vending Machine Context Protocol
-A monorepo containing packages that bridge Model Context Protocol (MCP) servers with Nostr's Data Vending Machine (DVM) ecosystem, enabling AI and computational tools to be discovered and utilized via Nostr's decentralized network.
+
+DVMCP (Data Vending Machine Context Protocol) is a project that bridges the Model Context Protocol (MCP) with Nostr's Data Vending Machine (DVM) ecosystem. It enables AI and computational services running on MCP servers to be seamlessly discovered, accessed, and utilized via the decentralized Nostr network.
+
+This integration combines MCP's standardized capability framework with Nostr's cryptographically secure and decentralized messaging, offering key advantages:
+
+*   **Discoverability**: MCP servers and their capabilities can be found through the Nostr network without centralized registries.
+*   **Verifiability**: Messages are cryptographically signed, ensuring authenticity and integrity.
+*   **Decentralization**: No single point of failure for service discovery or communication.
+*   **Protocol Interoperability**: Both MCP and DVMs leverage JSON-RPC patterns, facilitating smooth communication.
+
+For a detailed technical specification, refer to the [DVMCP Specification (2025-03-26)](./docs/dvmcp-spec-2025-03-26.md).
+
+## Event Kinds
+
+The following Nostr event kinds are defined and used within the DVMCP:
+
+| Kind  | Description                           |
+| ----- | ------------------------------------- |
+| 31316 | Server Announcement                   |
+| 31317 | Tools List                            |
+| 31318 | Resources List                        |
+| 31319 | Prompts List                          |
+| 25910 | Requests                              |
+| 26910 | Responses                             |
+| 21316 | Feedback/Notifications                |
+| 1059  | Encrypted Messages (NIP-59 Gift Wrap) |
+
 ## Packages
+
 This monorepo contains the following packages:
+
 ### [@dvmcp/bridge](./packages/dvmcp-bridge)
+
 The bridge implementation that connects MCP servers to Nostr's DVM ecosystem. Handles tool announcement, execution, and status updates.
+
 ### [@dvmcp/discovery](./packages/dvmcp-discovery)
+
 A MCP server/discovery service that aggregates MCP tools from DVMs and makes their tools available.
+
 ### [@dvmcp/commons](./packages/dvmcp-commons)
+
 Shared utilities and components used across DVMCP packages.
+
 ## Installation & Usage
+
 **Prerequisite:** Ensure you have [Bun](https://bun.sh/) installed.
 
 ### Quick Start with Bunx (No Installation)
+
 You can run the packages directly using `bunx` without installing them:
+
 ```bash
 # Run the bridge
 bunx dvmcp-bridge
 # Run the discovery service
 bunx dvmcp-discovery
 ```
+
 The interactive CLI will guide you through configuration setup on first run.
 
 ### Global Installation
+
 ```bash
 # Install the packages globally
 bun install -g @dvmcp/bridge @dvmcp/discovery
@@ -30,26 +69,10 @@ dvmcp-bridge
 dvmcp-discovery
 ```
 
-## Setting Up a Bridge
-To expose your MCP server as a DVM on Nostr:
-1. Navigate to the directory where you want to configure the bridge
-2. Run: `bunx dvmcp-bridge`
-3. Follow the interactive setup to configure:
-   - Your MCP server path
-   - Nostr private key (or generate a new one)
-   - Relays to connect to
-4. The bridge will start and begin proxying requests between Nostr and your MCP server
-
-## Setting Up a Discovery Service
-To aggregate MCP tools from DVMs:
-1. Navigate to your desired directory
-2. Run: `bunx dvmcp-discovery`
-3. Follow the setup to configure:
-   - Nostr private key
-   - Relays to monitor
-
 ## Development
+
 For contributors to this repository:
+
 ```bash
 # Clone the repo
 git clone https://github.com/gzuuus/dvmcp.git
@@ -59,5 +82,4 @@ bun install
 # Start the bridge in development mode
 bun run dev --cwd packages/dvmcp-bridge
 # Start the discovery service in development mode
-bun run dev --cwd packages/dvmcp-discovery
-```
+bun run dev --cwd packages/dvmcp-discovery

packages/dvmcp-bridge/README.md

@@ -5,11 +5,11 @@ A bridge implementation that connects Model Context Protocol (MCP) servers to No
 ## Features
 
 - Connect and manage multiple MCP servers through a single DVM instance
-- Automatic service announcement using NIP-89
-- Tool discovery and execution through DVM kind:5910/6910 events
-- Job status updates and payment handling via kind:7000 events
-- Service announcement deletion using NIP-09
-- Encrypted communication support using NIP-17/NIP-59
+- Automatic service announcement
+- Tool discovery and execution
+- Job status updates and payment handling
+- Service announcement deletion
+- Encrypted communication support
 - Comprehensive error handling
 
 ## Configuration