Add HyperSpell tool documentation and integrate it into the community tools list

Author: chaithanyak42

docs/tools/community.mdx

@@ -18,11 +18,13 @@ description: 'AgentStack tools from community contributors'
 ## Search
 - [Perplexity](/tools/tool/perplexity)
 - [Dappier](/tools/tool/dappier)
+- [HyperSpell](/tools/tool/hyperspell)
 
 ## Memory / State
 
 - [Mem0](/tools/tool/mem0)
 
+
 ## Database Tools
 - [Neon](/tools/tool/neon) 
 

docs/tools/tool/hyperspell.mdx

@@ -0,0 +1,77 @@
+---
+title: HyperSpell
+description: Personal knowledge base for agents
+---
+
+One integration, all the world's data. Hyperspell is the data platform that lets you build your AI-enabled apps faster. Let your users connect to dozens of services, and use Hyperspell's end-to-end data pipeline to get structured data with a single API call.
+
+## Description
+
+[HyperSpell](https://hyperspell.com) provides agents with the ability to build and query personal knowledge bases with:
+
+- Cross-Source Search across documents, emails, Notion, Gmail, and other integrations
+
+
+## Installation
+
+```bash
+agentstack tools add hyperspell
+```
+
+Set the environment variables in your project's `.env` file:
+
+```env
+HYPERSPELL_API_KEY=your_api_key_here
+HYPERSPELL_USER_ID=your_user_id_here
+```
+
+Get your API key and user ID from the [HyperSpell Dashboard](https://app.hyperspell.com/dashboard).
+
+## Available Functions
+
+The HyperSpell tool provides three core functions for knowledge management:
+
+### `hyperspell_search(query, sources=None, answer=False, user_id=None)`
+
+Search across your HyperSpell knowledge base for relevant information.
+
+#### Parameters:
+- `query` (str): The search query to find relevant information
+- `sources` (str, optional): Comma-separated list of sources to search (e.g., "collections,notion,gmail")
+- `answer` (bool, optional): If True, returns a direct AI answer instead of just documents. Defaults to False
+- `user_id` (str, optional): User ID to use for this request. Defaults to HYPERSPELL_USER_ID env var
+
+
+### `hyperspell_add_document(text, title=None, collection=None, user_id=None)`
+
+Add a text document to your HyperSpell knowledge base.
+
+#### Parameters:
+- `text` (str): The full text content to add
+- `title` (str, optional): Optional title for the document
+- `collection` (str, optional): Optional collection name to organize the document
+- `user_id` (str, optional): User ID to use for this request. Defaults to HYPERSPELL_USER_ID env var
+
+
+### `hyperspell_upload_file(file_path, collection=None, user_id=None)`
+
+Upload a file (PDF, Word doc, spreadsheet, etc.) to your HyperSpell knowledge base.
+
+#### Parameters:
+- `file_path` (str): Path to the file to upload
+- `collection` (str, optional): Optional collection name to organize the document  
+- `user_id` (str, optional): User ID to use for this request. Defaults to HYPERSPELL_USER_ID env var
+
+
+If no `user_id` is provided, the tool defaults to the `HYPERSPELL_USER_ID` environment variable.
+
+## Integration Sources
+
+HyperSpell can search across multiple integrated sources:
+- **collections**: Your uploaded documents and added text
+- **notion**: Connected Notion workspaces
+- **gmail**: Connected Gmail accounts
+- **and more**: Additional integrations available through the HyperSpell platform
+
+For detailed integration setup, visit the [HyperSpell documentation](https://docs.hyperspell.com).
+