Update README, version

Author: JerrySmidt

README.md

@@ -20,7 +20,28 @@ To run the MCP server directly, use the `uv tool` interface:
 uvx postcode-eu-ai-tools
 ```
 
-This starts the server on stdio transport. Connect via an MCP client (e.g., Claude Desktop or compatible tools) to use the address validation functions.
+This starts the server on STDIO transport.
+
+### Connect MCP clients
+
+Use the address validation tools in any client that supports local MCP servers. Just add the `uvx postcode-eu-ai-tools` command to your configuration.
+
+Example configuration for Claude Code:
+
+```json
+{
+  "mcpServers": {
+    "postcode-eu-address-validation": {
+      "command": "uvx",
+      "args": ["postcode-eu-ai-tools"],
+      "env": {
+        "POSTCODE_EU_API_KEY": "your_api_key",
+        "POSTCODE_EU_API_SECRET": "your_api_secret"
+      }
+    }
+  }
+}
+```
 
 ## Configuration
 
@@ -50,24 +71,83 @@ Look up a Dutch address by postcode (e.g., "1234AB") and house number (e.g., "69
 
 See https://developer.postcode.eu/documentation/nl/v1/Address/viewByPostcode
 
+**Examples**:
+
+User:
+> What is the address for postcode 2012es with house number 30?
+
+Assistant:
+>Julianastraat 30  
+2012ES Haarlem  
+Noord-Holland, Netherlands
+
+User:
+>What is the address for 2161AM with house number 166b?
+
+Assistant:
+>Stationsweg 166, 2161AM Lisse, Zuid-Holland, Netherlands (house number addition "b" incorrect).  
+Valid additions: "" (166) or "A" (166 A). Which one?
+
+User:
+>Is the address 1000AA 1 a PO box?
+
+Assistant:
+>Yes, Postbus 1, 1000AA Amsterdam, Noord-Holland, Netherlands (addressType: "PO box").
+
 ### validate_address
 
 Validate and complete an international address. Returns the first match if valid (meaning it's a full address that closely corresponds to the input). Otherwise returns an error message describing why the address is invalid. Partial addresses are considered invalid.
 
 See https://developer.postcode.eu/documentation/international/v1/Validate/validate
 
+**Examples**:
+
+User:
+>Can you validate the address "leystraat 11 2000 antwerpen"?
+
+Assistant:
+>Leysstraat 11  
+2000 Antwerpen  
+Belgium  
+Validated (grade B, building level).
+
+User:
+>How about "Kirsten Flagstads plass 1" in Oslo?
+
+Assistant:
+>Kirsten Flagstads plass 1  
+0150 Oslo  
+Norway  
+Validated (grade A, building level).
+
 ### get_supported_countries
 
 List countries that are supported for address validation.
 
 See https://developer.postcode.eu/documentation/international/v1/Autocomplete/getSupportedCountries
 
+**Example**:
+
+User:
+>For which countries can you validate addresses?
+
+Assistant:
+>Netherlands, Belgium, Germany, Luxembourg, Austria, Switzerland, France, United Kingdom, Spain, Denmark, Norway, Finland, Sweden.
+
 ### is_supported_country
 
 Check if a country is supported for address validation.
 
 See https://developer.postcode.eu/documentation/international/v1/Autocomplete/getSupportedCountries
 
+**Example**:
+
+User:
+>Could you validate an address from Kazakhstan?
+
+Assistant:
+>No, Kazakhstan (KAZ) is not supported.
+
 ## Requirements
 
 - Python 3.11+

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "postcode-eu-ai-tools"
-version = "0.1.0"
+version = "1.0.0"
 description = "AI tools / MCP server for address validation via the Postcode.eu API"
 license = "BSD-2-Clause"
 readme = "README.md"
@@ -28,10 +28,6 @@ build-backend = "uv_build"
 dev = [
     "ruff>=0.14",
 ]
-examples = [
-    "gradio>=5.0",
-    "python-dotenv>=1.0",
-]
 
 [tool.ruff]
 line-length = 120