update top level readme/contributing

Author: nevikashah

CONTRIBUTING.md

@@ -1,15 +1,16 @@
 # Developing
+We welcome contributions to all of our MCP servers! Here's a quick run down on how to get started. 
 
 ## Architecture
 
-The monorepo has two top-level directories:
+This monorepo has two top-level directories: `/apps` and `/packages`. 
 
-- apps: Contains the Workers for each MCP server
-  - apps/workers-observability
-  - apps/workers-bindings
-  - [apps/radar/CONTRIBUTING.md](apps/radar/CONTRIBUTING.md)
-  - apps/cloudflare-one-casb
-- packages: Contains shared packages used across our various apps.
+- **/apps**: Containing directories for each server. Within each server, you'll find a `CONTRIBUTING.md` with any special instructions on how to get set up: 
+  - [apps/workers-observability](apps/workers-observability)
+  - [apps/workers-bindings](apps/workers-bindings)
+  - [apps/radar](apps/radar)
+  - [apps/cloudflare-one-casb](apps/cloudflare-one-casb)
+- **/packages**: Containing shared packages used across our various apps.
   - packages/eslint-config: Eslint config used by all apps and packages.
   - packages/typescript-config: tsconfig used by all apps and packages.
   - packages/mcp-common: Shared common tools and scripts to help manage this repo.
@@ -20,7 +21,13 @@ We use [TurboRepo](https://turbo.build/) and [pnpm](https://pnpm.io/) to manage
 
 This section will guide you through setting up your developer environment and running tests.
 
-For more details on development in this monorepo, take a look at apps/workers-observability/CONTRIBUTING.md[/apps/workers-observability/CONTRIBUTING.md]
+### Installation
+
+Install dependencies:
+
+```bash
+pnpm install
+```
 
 ### Testing
 

README.md

@@ -1,6 +1,10 @@
 # Cloudflare MCP Server
 
-Model Context Protocol (MCP) is a [new, standardized protocol](https://modelcontextprotocol.io/introduction) for managing context between large language models (LLMs) and external systems. In this repository, you can find several MCP servers allowing you to connect to Cloudflare's service from an MCP client (e.g. Cursor, Claude Desktop) and use natural language to accomplish things on your Cloudflare account. The following servers are included in this repository:
+Model Context Protocol (MCP) is a [new, standardized protocol](https://modelcontextprotocol.io/introduction) for managing context between large language models (LLMs) and external systems. In this repository, you can find several MCP servers allowing you to connect to Cloudflare's service from an MCP client (e.g. Cursor, Claude) and use natural language to accomplish tasks through your Cloudflare account. 
+
+These MCP servers allow your [MCP Client](https://modelcontextprotocol.io/clients) to read configurations from your account, process information, make suggestions based on data, and even make those suggested changes for you. All of these actions can happen across cloudflare's many services including application development, security and performance. 
+
+The following servers are included in this repository:
 
 | Server Name                                     | Description                                                                  | Server URL                                     |
 | ----------------------------------------------- | ---------------------------------------------------------------------------- | ---------------------------------------------- |

apps/radar/README.md

@@ -36,7 +36,7 @@ This MCP server is still a work in progress, and we plan to add more tools in th
 
 ## Access the remote MCP server from from any MCP Client
 
-If your MCP client has first class support for remote MCP servers, the client will provide a way to accept the server URL directly within its interface (e.g. [Cloudflare AI Playground](https://playground.ai.cloudflare.com/))
+If your MCP client has first class support for remote MCP servers, the client will provide a way to accept the server URL (`https://radar.mcp.cloudflare.com`) directly within its interface (for example in[Cloudflare AI Playground](https://playground.ai.cloudflare.com/)). 
 
 If your client does not yet support remote MCP servers, you will need to set up its resepective configuration file using mcp-remote (https://www.npmjs.com/package/mcp-remote) to specify which servers your client can access.