# MCP Server ConsignSpace
A Model Context Protocol (MCP) server for ConsignSpace reseller API integration with Claude Desktop.
## Features
- 🛒 **Cart Management**: Add, update, remove products from cart
- 📦 **Order Processing**: Create orders, retrieve order details
- 🔍 **Product Search**: Search products with filters
- 🔐 **Secure Authentication**: Token-based API authentication
- 🔄 **Real-time Updates**: Live cart and order synchronization
## Installation
Install using pipx (recommended):
```bash
pipx install mcp-server-consignspace
```
Or using pip:
```bash
pip install mcp-server-consignspace
```
## Configuration
### 1. Get Your ConsignSpace API Token
1. Visit [ConsignSpace Token Generator](https://test.consignspace.com.au/reseller/generate_api_token.php)
2. Generate your access token
3. Copy the token for configuration
### 2. Configure Claude Desktop
Add the server to your Claude Desktop configuration file:
**Location**: `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS)
```json
{
"mcpServers": {
"consignspace": {
"command": "mcp-server-consignspace",
"env": {
"CONSIGNSPACE_ACCESS_TOKEN": "your-token-here"
}
}
}
}
```
### 3. Restart Claude Desktop
Restart Claude Desktop to load the new server configuration.
## Available Tools
### Cart Operations
- `add-to-cart`: Add products to cart
- `get-cart`: View current cart contents
- `update-cart-quantity`: Update product quantities
- `remove-from-cart`: Remove items from cart
- `clear-cart`: Empty the cart
### Order Operations
- `create-order`: Create new order from cart
- `get-order`: Retrieve order details by ID
### Product Operations
- `get-products`: Search and browse products
- `test-auth`: Test API authentication
### Configuration
- `set-api-config`: Update API settings (optional)
## Usage Examples
### Search for Products
```
Can you search for "Charizard V (SWSH133)" products?
```
### Add to Cart
```
Add product ID 108323 to cart with quantity 2
```
### View Cart
```
Show me my current cart contents
```
### Create Order
```
Create an order with customer email "customer@example.com"
```
### Check Order Status
```
Get details for order 07-11-25-48265
```
## Environment Variables
| Variable | Description | Required |
|----------|-------------|----------|
| `CONSIGNSPACE_ACCESS_TOKEN` | Your ConsignSpace API token | Yes |
| `API_BASE_URL` | API base URL (optional) | No |
## Requirements
- Python 3.8+
- ConsignSpace reseller account
- Claude Desktop
## Support
- **Repository**: [GitHub Issues](https://github.com/EvanGan2023/mcp-server-consignspace/issues)
- **ConsignSpace API**: [Official Documentation](https://test.consignspace.com.au/reseller/api/)
## License
MIT License - see LICENSE file for details.
## Contributing
1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Submit a pull request
## Changelog
### 0.1.0
- Initial release
- Cart and order management
- Product search functionality
- Authentication support
- Claude Desktop integration
Raw data
{
"_id": null,
"home_page": null,
"name": "mcp-server-consignspace",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": "ai, cart, claude, consignspace, mcp, orders, reseller",
"author": null,
"author_email": "EvanGan2023 <134857100+EvanGan2023@users.noreply.github.com>",
"download_url": "https://files.pythonhosted.org/packages/8a/c9/f8b309575544d6a274fc086e86ed24520e26ff5d9b3c787a9b06e91c75dc/mcp_server_consignspace-0.1.2.tar.gz",
"platform": null,
"description": "# MCP Server ConsignSpace\n\nA Model Context Protocol (MCP) server for ConsignSpace reseller API integration with Claude Desktop.\n\n## Features\n\n- \ud83d\uded2 **Cart Management**: Add, update, remove products from cart\n- \ud83d\udce6 **Order Processing**: Create orders, retrieve order details\n- \ud83d\udd0d **Product Search**: Search products with filters\n- \ud83d\udd10 **Secure Authentication**: Token-based API authentication\n- \ud83d\udd04 **Real-time Updates**: Live cart and order synchronization\n\n## Installation\n\nInstall using pipx (recommended):\n\n```bash\npipx install mcp-server-consignspace\n```\n\nOr using pip:\n\n```bash\npip install mcp-server-consignspace\n```\n\n## Configuration\n\n### 1. Get Your ConsignSpace API Token\n\n1. Visit [ConsignSpace Token Generator](https://test.consignspace.com.au/reseller/generate_api_token.php)\n2. Generate your access token\n3. Copy the token for configuration\n\n### 2. Configure Claude Desktop\n\nAdd the server to your Claude Desktop configuration file:\n\n**Location**: `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS)\n\n```json\n{\n \"mcpServers\": {\n \"consignspace\": {\n \"command\": \"mcp-server-consignspace\",\n \"env\": {\n \"CONSIGNSPACE_ACCESS_TOKEN\": \"your-token-here\"\n }\n }\n }\n}\n```\n\n### 3. Restart Claude Desktop\n\nRestart Claude Desktop to load the new server configuration.\n\n## Available Tools\n\n### Cart Operations\n- `add-to-cart`: Add products to cart\n- `get-cart`: View current cart contents\n- `update-cart-quantity`: Update product quantities\n- `remove-from-cart`: Remove items from cart\n- `clear-cart`: Empty the cart\n\n### Order Operations\n- `create-order`: Create new order from cart\n- `get-order`: Retrieve order details by ID\n\n### Product Operations\n- `get-products`: Search and browse products\n- `test-auth`: Test API authentication\n\n### Configuration\n- `set-api-config`: Update API settings (optional)\n\n## Usage Examples\n\n### Search for Products\n```\nCan you search for \"Charizard V (SWSH133)\" products?\n```\n\n### Add to Cart\n```\nAdd product ID 108323 to cart with quantity 2\n```\n\n### View Cart\n```\nShow me my current cart contents\n```\n\n### Create Order\n```\nCreate an order with customer email \"customer@example.com\"\n```\n\n### Check Order Status\n```\nGet details for order 07-11-25-48265\n```\n\n## Environment Variables\n\n| Variable | Description | Required |\n|----------|-------------|----------|\n| `CONSIGNSPACE_ACCESS_TOKEN` | Your ConsignSpace API token | Yes |\n| `API_BASE_URL` | API base URL (optional) | No |\n\n## Requirements\n\n- Python 3.8+\n- ConsignSpace reseller account\n- Claude Desktop\n\n## Support\n\n- **Repository**: [GitHub Issues](https://github.com/EvanGan2023/mcp-server-consignspace/issues)\n- **ConsignSpace API**: [Official Documentation](https://test.consignspace.com.au/reseller/api/)\n\n## License\n\nMIT License - see LICENSE file for details.\n\n## Contributing\n\n1. Fork the repository\n2. Create a feature branch\n3. Make your changes\n4. Submit a pull request\n\n## Changelog\n\n### 0.1.0\n- Initial release\n- Cart and order management\n- Product search functionality\n- Authentication support\n- Claude Desktop integration",
"bugtrack_url": null,
"license": "MIT",
"summary": "ConsignSpace MCP server for Claude Desktop - manage cart and orders",
"version": "0.1.2",
"project_urls": {
"Homepage": "https://github.com/EvanGan2023/mcp-server-consignspace",
"Issues": "https://github.com/EvanGan2023/mcp-server-consignspace/issues",
"Repository": "https://github.com/EvanGan2023/mcp-server-consignspace"
},
"split_keywords": [
"ai",
" cart",
" claude",
" consignspace",
" mcp",
" orders",
" reseller"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "c3ee292ee3099e8ef6e0c9e94b73ed55ba2d197d6b066b39fd631aaa5e871e5d",
"md5": "5c445615e7108905e424b9a7e8fa3799",
"sha256": "a9e8374c6d172e6a81e7581f801af883ed92e3defffc420e997e99633e97241f"
},
"downloads": -1,
"filename": "mcp_server_consignspace-0.1.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "5c445615e7108905e424b9a7e8fa3799",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 8874,
"upload_time": "2025-07-12T12:10:41",
"upload_time_iso_8601": "2025-07-12T12:10:41.173455Z",
"url": "https://files.pythonhosted.org/packages/c3/ee/292ee3099e8ef6e0c9e94b73ed55ba2d197d6b066b39fd631aaa5e871e5d/mcp_server_consignspace-0.1.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "8ac9f8b309575544d6a274fc086e86ed24520e26ff5d9b3c787a9b06e91c75dc",
"md5": "8a51f67e4e69d619ce067a3cebb2462f",
"sha256": "0e899e7cbf1070c20fb91c5f35f41ca8862c5ccb6ccc364e4894e68e55e4851b"
},
"downloads": -1,
"filename": "mcp_server_consignspace-0.1.2.tar.gz",
"has_sig": false,
"md5_digest": "8a51f67e4e69d619ce067a3cebb2462f",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 38992,
"upload_time": "2025-07-12T12:10:42",
"upload_time_iso_8601": "2025-07-12T12:10:42.458327Z",
"url": "https://files.pythonhosted.org/packages/8a/c9/f8b309575544d6a274fc086e86ed24520e26ff5d9b3c787a9b06e91c75dc/mcp_server_consignspace-0.1.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-12 12:10:42",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "EvanGan2023",
"github_project": "mcp-server-consignspace",
"github_not_found": true,
"lcname": "mcp-server-consignspace"
}
JSON
