docs: readme

1 files changed, 22 insertions, 24 deletions

diff --git a/README.md b/README.md
index 2f19371e1..5924c906b 100644
--- a/README.md
+++ b/README.md
@@ -55,7 +55,28 @@ Project configuration is optional. You can place an `opencode.json` file in the
 }
 ```
 
-### Providers
+#### MCP
+
+```json title="opencode.json"
+{
+  "$schema": "http://opencode.ai/config.json",
+  "mcp": {
+    "localmcp": {
+      "type": "local",
+      "command": ["bun", "x", "my-mcp-command"],
+      "environment": {
+        "MY_ENV_VAR": "my_env_var_value"
+      }
+    },
+    "remotemcp": {
+      "type": "remote",
+      "url": "https://my-mcp-server.com"
+    }
+  }
+}
+```
+
+#### Providers
 
 You can use opencode with any provider listed at [here](https://ai-sdk.dev/providers/ai-sdk-providers). Use the npm package name as the key in your config. Note we use v5 of the ai-sdk and not all providers support that yet.
 
@@ -79,29 +100,6 @@ You can use opencode with any provider listed at [here](https://ai-sdk.dev/provi
 }
 ```
 
-#### Provider Options
-
-#### MCP
-
-```json title="opencode.json"
-{
-  "$schema": "http://opencode.ai/config.json",
-  "mcp": {
-    "localmcp": {
-      "type": "local",
-      "command": ["bun", "x", "my-mcp-command"],
-      "environment": {
-        "MY_ENV_VAR": "my_env_var_value"
-      }
-    },
-    "remotemcp": {
-      "type": "remote",
-      "url": "https://my-mcp-server.com"
-    }
-  }
-}
-```
-
 ### Contributing
 
 To run opencode locally you need