current-rms-mcp

nospi/current-rms-mcp

3.2

If you are the rightful owner of current-rms-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to dayong@mcphub.com.

The Current RMS MCP Server is a Model Context Protocol server designed to integrate with the Current RMS rental management system API, enabling AI assistants to manage inventory, opportunities, and customer information.

Tools
7
Resources
0
Prompts
0

Current RMS MCP Server

npm version License: MIT

A Model Context Protocol (MCP) server for integrating with Current RMS - a rental management system API. This server enables AI assistants like Claude to interact with your Current RMS data, managing inventory, opportunities, and customer information.

🚀 Quick Start

The fastest way to use this MCP server is with npx:

npx @nospi/current-rms-mcp

You'll need to set environment variables for authentication (see Configuration section below).

📋 Prerequisites

  • Node.js 18 or higher
  • A Current RMS account with API access
  • API credentials (subdomain and API key)

Getting Current RMS API Credentials

  1. Log into your Current RMS account
  2. Navigate to System Setup > Integrations > API
  3. Generate a new API key
  4. Note your subdomain (e.g., if your URL is mycompany.current-rms.com, your subdomain is mycompany)

📦 Installation

Method 1: Using npx (Recommended)

No installation needed! Just run:

CURRENT_SUBDOMAIN=your-subdomain CURRENT_API_KEY=your-api-key npx @nospi/current-rms-mcp

Method 2: Global Installation

npm install -g @nospi/current-rms-mcp

Then run:

current-rms-mcp

Method 3: From Source

# Clone the repository
git clone https://github.com/nospi/current-rms-mcp.git
cd current-rms-mcp

# Install dependencies
npm install

# Build the project
npm run build

# Run the server
npm start

🔧 Configuration

Environment Variables

Create a .env file in your project root (or set environment variables):

CURRENT_SUBDOMAIN=your-subdomain
CURRENT_API_KEY=your-api-key

Claude Desktop Integration

Add this configuration to your Claude Desktop settings:

For npx usage:

{
  "mcpServers": {
    "current-rms": {
      "command": "npx",
      "args": ["@nospi/current-rms-mcp"],
      "env": {
        "CURRENT_SUBDOMAIN": "your-subdomain",
        "CURRENT_API_KEY": "your-api-key"
      }
    }
  }
}

For global installation:

{
  "mcpServers": {
    "current-rms": {
      "command": "current-rms-mcp",
      "env": {
        "CURRENT_SUBDOMAIN": "your-subdomain",
        "CURRENT_API_KEY": "your-api-key"
      }
    }
  }
}

For local development:

{
  "mcpServers": {
    "current-rms": {
      "command": "node",
      "args": ["/absolute/path/to/current-rms-mcp/dist/index.js"],
      "env": {
        "CURRENT_SUBDOMAIN": "your-subdomain",
        "CURRENT_API_KEY": "your-api-key"
      }
    }
  }
}

🛠️ Available Tools

Product Management

list_products

Search and list products from your inventory.

// Example: List products with pagination
{
  "page": 1,
  "per_page": 20,
  "q": {
    "product_group_id_eq": 5,
    "tag_names_contains": "audio"
  }
}
get_product

Get detailed information about a specific product.

// Example: Get product by ID
{
  "id": 123
}

Opportunity Management

list_opportunities

List rental opportunities (quotes/orders).

// Example: List confirmed opportunities in date range
{
  "page": 1,
  "per_page": 10,
  "q": {
    "state_eq": 3,  // 3 = Confirmed
    "starts_at_gteq": "2024-01-01T00:00:00Z",
    "ends_at_lteq": "2024-12-31T23:59:59Z"
  }
}

State values:

  • 0: Open
  • 1: Provisional
  • 2: Reserved
  • 3: Confirmed
  • 5: Cancelled
  • 6: Ended
  • 7: Lost
get_opportunity

Get details of a specific opportunity.

{
  "id": 456
}

Availability

check_availability

Check product availability for a specific date range.

// Example: Check if product is available for rental
{
  "product_id": 123,
  "starts_at": "2024-03-15T09:00:00Z",
  "ends_at": "2024-03-20T17:00:00Z",
  "store_id": 1
}

Customer Management

list_members

List members (customers/contacts).

// Example: Search for active customers by name
{
  "page": 1,
  "per_page": 20,
  "q": {
    "name_cont": "Smith",
    "active_eq": true
  }
}
get_member

Get detailed information about a specific member.

{
  "id": 789
}

🧪 Development

Running in Development Mode

npm run dev

Building

npm run build

Testing

Test the server connection:

node test-server.js

📝 Example Usage with Claude

Once configured, you can ask Claude to:

  • "List all audio equipment available next week"
  • "Check if the Canon 5D Mark IV is available from March 15-20"
  • "Show me all confirmed orders for this month"
  • "Find customer John Smith's contact information"
  • "List products with the tag 'lighting' in inventory"

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/AmazingFeature)
  3. Commit your changes (git commit -m 'Add some AmazingFeature')
  4. Push to the branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

🐛 Troubleshooting

Common Issues

Authentication Failed

  • Verify your subdomain and API key are correct
  • Check that your API key has the necessary permissions
  • Ensure environment variables are properly set

Connection Errors

  • Check your internet connection
  • Verify Current RMS API is accessible
  • Check for any firewall restrictions

Rate Limiting

  • Current RMS has API rate limits
  • Implement appropriate delays between requests if needed
  • Contact Current RMS support if you need higher limits

📄 License

This project is licensed under the MIT License - see the file for details.

🔗 Links

💬 Support

For issues and questions:

Made with ❤️ by nospi