StashDog
- typescript
0
GitHub Stars
typescript
Language
6 months ago
First Indexed
3 months ago
Catalog Refreshed
Documentation & install
Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.
Installation
Add the following to your MCP client configuration file.
Configuration
View docs{
"mcpServers": {
"dogfoodlab-io-stashdog-mcp-server": {
"command": "node",
"args": [
"/path/to/stashdog-mcp-server/dist/index.js"
],
"env": {
"STASHDOG_EMAIL": "user@example.com",
"STASHDOG_API_URL": "http://localhost:3000/graphql",
"STASHDOG_PASSWORD": "your_password",
"STASHDOG_AUTH_TOKEN": "your_token_here"
}
}
}
}You can run a StashDog MCP Server to let an AI assistant manage your inventory through natural language commands. It exposes actions like adding, searching, organizing items, managing collections and tags, importing from URLs, and securely authenticating with your StashDog account. This makes inventory management conversational and fast while keeping data organized and searchable.
How to use
Interact with the MCP server through a compatible client that can send natural language commands. You can authenticate once you’ve connected your StashDog account, then perform actions like adding new items, updating details, searching with complex queries, organizing items into collections, and importing from URLs. Use clear phrases such as “Add item named Wireless Mouse with tags office, electronics” or “Find items tagged with electronics in storage containers” to drive AI-assisted inventory management.
Key capabilities you can leverage include: authenticating to your account, managing inventory items (add, update, search, delete), creating and managing collections, handling tags, importing data from URLs, and performing smart searches that interpret natural language queries. When you issue commands, the server will return structured, human‑readable responses with status indicators and data such as item IDs and tag lists.
How to install
Prerequisites: Ensure you have Node.js and npm installed on your machine.
-
Clone or download the MCP server to your machine. 2. Open a terminal in the project directory.
-
Install dependencies.
-
Build the server.
-
Configure environment variables by copying the example and editing it with your StashDog API details.
Configuration and usage notes
Environment variables you’ll typically configure include the API URL and an authentication token. You can optionally provide pre-configured credentials for automatic login.
You will also configure the MCP client to connect to this server. The following configuration demonstrates the standard local runtime setup.
Security and access
Use secure authentication methods to protect access to your StashDog data. The server supports token-based environment authentication and runtime authentication. If you enable auto-login, ensure your credentials are protected and not shared.
Examples and common workflows
Authenticate with your account, add a few items with tags, create a collection, search for electronics, then get inventory stats. You can also import data from a product URL to quickly populate your inventory.
Available tools
authenticate
Authenticate to your StashDog account to enable secure interactions with the MCP server.
manage_inventory_items
Add, update, search, delete, and manage items in your inventory using natural language.
manage_collections
Create, update, delete, and manage collections and the items within them.
import_from_url
Import items into your inventory directly from URLs.
manage_tags
Create, rename, search, and delete tags to organize items.
get_inventory_stats
Retrieve statistics about your inventory (counts, distributions, etc.).
smart_search
Perform intelligent, natural language searches across your inventory.
manage_users
Fetch user details and manage user-related information.
manage_notifications
Fetch and review user notifications.
manage_groups
Fetch and manage user groups.
manage_subscriptions
Handle subscription details and creation of new subscriptions.
