docs: Update README with accurate READ-ONLY documentation and new badges

- Add PyPI downloads and GitHub Actions workflow badges
- Correct documentation to reflect READ-ONLY nature of the tool
- Remove misleading CRUD operation references
- Add comprehensive safety explanations and use cases
- Update examples to show only supported read-only operations

Author: eraykeskinmac

README.md

@@ -1,21 +1,24 @@
 # strands-hubspot
 
 [![PyPI version](https://img.shields.io/pypi/v/strands-hubspot.svg)](https://pypi.org/project/strands-hubspot/)
+[![PyPI - Downloads](https://img.shields.io/pypi/dm/strands-hubspot)](https://pypi.org/project/strands-hubspot/)
 [![Python Support](https://img.shields.io/pypi/pyversions/strands-hubspot.svg)](https://pypi.org/project/strands-hubspot/)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![GitHub Workflow Status](https://github.com/eraykeskinmac/strands-hubspot/actions/workflows/publish.yml/badge.svg)](https://github.com/eraykeskinmac/strands-hubspot/actions)
 
-HubSpot CRM tool for [Strands Agents SDK](https://github.com/strands-agents/strands). Enables powerful CRM operations for AI agents with read-only access for safety.
+**READ-ONLY** HubSpot CRM tool for [Strands Agents SDK](https://github.com/strands-agents/strands). Enables safe CRM data access for AI agents with **zero risk** of data modification.
 
 ## Features
 
-- **Universal CRM Access**: Works with ANY HubSpot object type
-- **Smart Search**: Advanced filtering with property-based queries
-- **CRUD Operations**: Create, read, update, and delete records
-- **Property Discovery**: Automatic field detection and validation
-- **Association Management**: Link related objects (contacts, deals, companies)
-- **Rich Console Output**: Beautiful table displays with Rich library
-- **Type Safe**: Full type hints and validation
-- **Easy Integration**: Drop-in tool for Strands agents
+- 🔍 **Universal READ-ONLY Access**: Safely search ANY HubSpot object type (contacts, deals, companies, tickets, etc.)
+- 🔎 **Smart Search**: Advanced filtering with property-based queries and sorting
+- 📄 **Object Retrieval**: Get detailed information for specific CRM objects by ID
+- 🏷️ **Property Discovery**: List and explore all available properties for any object type
+- 👤 **User Management**: Get HubSpot user/owner details and assignments
+- 🎨 **Rich Console Output**: Beautiful table displays with Rich library formatting
+- 🛡️ **100% Safe**: **NO CREATE, UPDATE, or DELETE** operations - read-only by design
+- 🔧 **Easy Integration**: Drop-in tool for Strands agents
+- 📝 **Type Safe**: Full type hints and comprehensive error handling
 
 ## Requirements
 
@@ -35,17 +38,20 @@ pip install strands-hubspot
 from strands import Agent
 from strands_hubspot import hubspot
 
-# Create an agent with HubSpot tool
+# Create an agent with HubSpot READ-ONLY tool
 agent = Agent(tools=[hubspot])
 
-# Search contacts
+# Search contacts (READ-ONLY)
 agent("find all contacts created in the last 30 days")
 
-# Create a deal
-agent("create a deal called 'Acme Corp Q4' with amount 50000")
-
-# Get company details
+# Get company details (READ-ONLY)
 agent("get company information for ID 67890")
+
+# List available properties (READ-ONLY)
+agent("show me all available deal properties")
+
+# Search with filters (READ-ONLY)
+agent("search for deals with amount greater than 10000")
 ```
 
 ## Configuration
@@ -59,7 +65,9 @@ HUBSPOT_DEFAULT_LIMIT=100              # Optional
 
 Get your API key at: [app.hubspot.com/private-apps](https://app.hubspot.com/private-apps)
 
-## Supported Actions
+## Supported READ-ONLY Actions
+
+> ⚠️ **Important**: This tool is designed for READ-ONLY operations only. It **CANNOT** create, update, or delete any HubSpot data, ensuring complete safety for your CRM.
 
 ### Search (`search`)
 
@@ -71,8 +79,8 @@ agent("search for contacts with email containing '@example.com'")
 
 - Search any HubSpot object type (contacts, deals, companies, tickets, etc.)
 - Advanced filtering by property values
-- Sorting and pagination
-- Property selection
+- Sorting and pagination support
+- Property selection and customization
 
 ### Get (`get`)
 
@@ -82,45 +90,34 @@ agent("get contact with ID 12345")
 
 **Features:**
 
-- Retrieve full object details
+- Retrieve full object details by ID
 - Specify which properties to return
 - Works with any object type
+- Comprehensive error handling
 
-### Create (`create`)
-
-```python
-agent("create a contact with email [email protected] and name John Doe")
-```
-
-**Features:**
-
-- Create any HubSpot object
-- Set initial properties
-- Handle associations
-
-### Update (`update`)
+### List Properties (`list_properties`)
 
 ```python
-agent("update contact 12345 with lifecycle stage 'customer'")
+agent("show me all available contact properties")
 ```
 
 **Features:**
 
-- Update any property
-- Partial updates supported
-- Property validation
+- Discover available fields for any object type
+- Property metadata and type information
+- Field types and available options
 
-### List Properties (`list_properties`)
+### Get Property Details (`get_property`)
 
 ```python
-agent("show me all available contact properties")
+agent("get details about the 'email' property for contacts")
 ```
 
 **Features:**
 
-- Discover available fields
-- Property metadata
-- Field types and options
+- Detailed property metadata
+- Property type, options, and validation rules
+- Useful for understanding data structure
 
 ### Get User Details (`get_user_details`)
 
@@ -132,6 +129,26 @@ agent("get details for user ID 123")
 
 - User profile information
 - Owner assignment data
+- Permission and role details
+
+## Why READ-ONLY?
+
+🛡️ **Safety First**: This tool is intentionally designed as READ-only to:
+
+- **Prevent accidental data loss** or corruption in your HubSpot CRM
+- **Enable safe AI exploration** of your customer data
+- **Allow analytics and reporting** without modification risks
+- **Perfect for research and insights** without affecting production data
+- **Ideal for AI agents** that need CRM access but shouldn't modify records
+
+## Use Cases
+
+- 📊 **Analytics & Reporting**: Generate insights from CRM data
+- 🔍 **Customer Research**: Search and analyze customer information
+- 📋 **Data Discovery**: Explore available properties and data structure
+- 🤖 **AI-Powered Insights**: Let agents analyze CRM data safely
+- 📈 **Sales Intelligence**: Extract trends and patterns from deals/contacts
+- 🎯 **Lead Analysis**: Research prospects and opportunities
 
 ## Testing