diff --git a/README.md b/README.md
index f7d59ad..7d199fc 100644
--- a/README.md
+++ b/README.md
@@ -48,16 +48,19 @@ include the following:
 ```conf
 [default]
 host = azure.relationalai.com
-port = <api-port>      # optional, default: 443
-scheme = <scheme>      # optional, default: https
 client_id = <your client_id>
 client_secret = <your client secret>
-client_credentials_url = <account login URL>  # optional
-# default: https://login.relationalai.com/oauth/token
+
+# the following are all optional, with default values shown
+# port = 443
+# scheme = https
+# client_credentials_url = https://login.relationalai.com/oauth/token
 ```
 
 Client credentials can be created using the RAI console at https://console.relationalai.com/login
 
+You can copy `config.spec` from the root of this repo and modify as needed.
+
 ## Examples
 
 ```shell
diff --git a/config.spec b/config.spec
new file mode 100644
index 0000000..228708e
--- /dev/null
+++ b/config.spec
@@ -0,0 +1,9 @@
+[default]
+host = azure.relationalai.com
+client_id = <your client_id>
+client_secret = <your client secret>
+
+# the following are all optional, with default values shown
+# port = 443
+# scheme = https
+# client_credentials_url = https://login.relationalai.com/oauth/token
\ No newline at end of file