Openprovider MCP Server

This is a Model Context Protocol (MCP) server for Openprovider.com that allows users to interact with their Openprovider account to perform various domain management actions.

Features

The Openprovider MCP server provides comprehensive domain and hosting management tools:

🔐 Authentication

login: Authenticate with Openprovider and get a token

🌐 Domain Management

check_domain: Check domain availability
search_domains: Search for available domains with AI-powered suggestions
register_domain: Register a new domain
list_domains: List domains in your Openprovider account
get_domain: Get domain details
renew_domain: Renew domain registration
update_domain_nameservers: Update nameservers for a domain
lock_domain: Lock domain to prevent unauthorized transfers
unlock_domain: Unlock a domain

🔄 Domain Transfer

transfer_domain: Transfer a domain to Openprovider
check_transfer_status: Check the status of a domain transfer

👥 Contact Management

list_contacts: List contacts in your Openprovider account
create_contact: Create a new contact
update_contact: Update an existing contact
get_contact: Get contact details by ID
delete_contact: Delete a contact by ID

🔒 Privacy & Security

enable_whois_privacy: Enable WHOIS privacy protection
get_whois_info: Get WHOIS information for a domain
enable_dnssec: Enable DNSSEC for enhanced security
disable_dnssec: Disable DNSSEC
get_dnssec_info: Get DNSSEC configuration details

🗂️ DNS Zone Management

create_dns_zone: Create a DNS zone for a domain
list_dns_zones: List all DNS zones
get_dns_zone: Get DNS zone details
delete_dns_zone: Delete a DNS zone

📝 DNS Records Management

list_dns_records: List DNS records for a zone
create_dns_record: Create DNS records (A, AAAA, CNAME, MX, TXT, SPF, NS, SOA, PTR, SRV, CAA)
update_dns_record: Update existing DNS records
delete_dns_record: Delete DNS records

🔐 SSL Certificate Management

list_ssl_products: Browse available SSL certificate products
order_ssl_certificate: Order a new SSL certificate
list_ssl_orders: List all SSL certificate orders
get_ssl_order: Get SSL order details
reissue_ssl_certificate: Reissue an SSL certificate
renew_ssl_certificate: Renew an SSL certificate
cancel_ssl_order: Cancel an SSL order

📧 Email Management

create_email_forward: Set up email forwarding
list_email_forwards: List email forwarding rules
delete_email_forward: Remove email forwarding

Installation

1. Install Node.js

Before installing the MCP server, make sure Node.js 20+ is installed. You can do this via Node Version Manager (nvm):

# Install nvm (if not already installed)
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

# Reload shell
source ~/.bashrc

# Install Node.js 20
nvm install 20

# Set it as default
nvm use 20

2. Clone the Repository

git clone git@github.com:hichamdotpage/openprovider-mcp.git
cd openprovider-mcp

3. Install Dependencies

npm install

4. Build the Project

npm run build

5. Test the Server

npm test

The test suite exercises the CLI --help path to make sure the binary is callable and that its usage text mentions the most important flags and environment variables. This runs without touching the Openprovider API, so you can run it safely on any machine or CI environment without real credentials.

6. Install Globally (Optional)

You can install the MCP server globally to use it as a CLI tool:

# Install globally from the local directory
npm install -g .

# Or with yarn
yarn global add .

# Or with pnpm
pnpm add -g .

After installing globally, you can run the server from anywhere using:

openprovider-mcp

Configuration

Environment Variables

The server can be configured using environment variables. Create a .env file in the root directory based on the provided .env.example:

# Openprovider API Credentials
OPENPROVIDER_USERNAME=your_username
OPENPROVIDER_PASSWORD=your_password

# Debug mode (true/false)
DEBUG=false

Integration with AI Assistants

Cursor Integration

To use the Openprovider MCP server with Cursor, you need to add it to your Cursor MCP settings file located at:

~/.cursor/mcp/config.json

Add the following configuration:

{
  "servers": {
    "openprovider": {
      "command": "node",
      "args": ["/path/to/openprovider-server/server.js"],
      "env": {
        "OPENPROVIDER_USERNAME": "your_username",
        "OPENPROVIDER_PASSWORD": "your_password",
        "DEBUG": "false"
      }
    }
  }
}

Claude Integration

To use the Openprovider MCP server with Claude, you need to run the server and provide the endpoint to Claude. First, start the server:

node server.js --port 3000

Then, in Claude, you can connect to the MCP server using the following configuration:

MCP Server Configuration:
- Name: openprovider
- Endpoint: http://localhost:3000
- Authentication: None (authentication is handled by the server)

You can then use the MCP tools in Claude by using the following syntax:

<mcp name="openprovider" tool="check_domain">
{
  "domains": [
    {
      "name": "example",
      "extension": "com"
    }
  ],
  "with_price": true
}
</mcp>

Usage

Once configured, you can use the Openprovider MCP server with Claude, ChatGPT, Cursor or any other platform that supports the Model Context Protocol.

Example: Checking Domain Availability

<use_mcp_tool>
<server_name>openprovider</server_name>
<tool_name>check_domain</tool_name>
<arguments>
{
  "domains": [
    {
      "name": "example",
      "extension": "com"
    },
    {
      "name": "example",
      "extension": "org"
    }
  ],
  "with_price": true
}
</arguments>
</use_mcp_tool>

Example: Registering a Domain

<use_mcp_tool>
<server_name>openprovider</server_name>
<tool_name>register_domain</tool_name>
<arguments>
{
  "domain": {
    "name": "example",
    "extension": "com"
  },
  "period": 1,
  "owner_handle": "ABC123",
  "name_servers": [
    {
      "name": "ns1.example.com"
    },
    {
      "name": "ns2.example.com"
    }
  ]
}
</arguments>
</use_mcp_tool>

Documentation

Detailed documentation for all available tools can be found in the docs directory:

Tools Documentation: Detailed information about each tool, including input schemas, examples, and responses.
Troubleshooting Guide: Solutions to common issues you might encounter when using the Openprovider MCP server.

Examples

The repository includes example scripts that demonstrate how to use the Openprovider MCP server:

Domain Check Example

This example demonstrates how to check domain availability:

npm run example:check

Domain Registration Example

This example demonstrates how to register a new domain:

npm run example:register

Integration with Workflows

This MCP server can be used with workflow automation platforms like n8n to implement complex domain management workflows. The server exposes a standardized interface that can be accessed programmatically.

The examples in the examples directory show how to integrate with the MCP server programmatically using Node.js.

n8n Workflow Example

An example n8n workflow is provided in the examples/n8n-workflow.json file. This workflow demonstrates how to:

Check domain availability
Display domain status and pricing
List contacts if the domain is available

To use this workflow:

Import the workflow JSON file into your n8n instance
Set up environment variables for OPENPROVIDER_USERNAME and OPENPROVIDER_PASSWORD
Make sure the Openprovider MCP server is running locally
Activate and run the workflow

Contributing

We welcome contributions to the Openprovider MCP Server! Please see the Contributing Guide for more information on how to get started.

About Openprovider

Openprovider is a wholesaler of Internet services and products with a unique platform from which you can find and manage all the products you need: Domains, new gTLDs, SSL certificates, licenses for Plesk, spam filters, and more!

For more information, visit Openprovider.com.

Repository

The source code for this project is available on GitHub:

git@github.com:hichamdotpage/openprovider-mcp.git

You can view the repository at https://github.com/hichamdotpage/openprovider-mcp

License

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

Name		Name	Last commit message	Last commit date
Latest commit History 14 Commits
build		build
docs		docs
examples		examples
src		src
test		test
.env.example		.env.example
.gitignore		.gitignore
CONTRIBUTING.md		CONTRIBUTING.md
LICENSE		LICENSE
README-ENHANCED.md		README-ENHANCED.md
README.md		README.md
index.js		index.js
package-lock.json		package-lock.json
package.json		package.json
server.js		server.js
tsconfig.json		tsconfig.json

Folders and files

Latest commit

History

Repository files navigation

Openprovider MCP Server

Features

🔐 Authentication

🌐 Domain Management

🔄 Domain Transfer

👥 Contact Management

🔒 Privacy & Security

🗂️ DNS Zone Management

📝 DNS Records Management

🔐 SSL Certificate Management

📧 Email Management

Installation

1. Install Node.js

2. Clone the Repository

3. Install Dependencies

4. Build the Project

5. Test the Server

6. Install Globally (Optional)

Configuration

Environment Variables

Integration with AI Assistants

Cursor Integration

Claude Integration

Usage

Example: Checking Domain Availability

Example: Registering a Domain

Documentation

Examples

Domain Check Example

Domain Registration Example

Integration with Workflows

n8n Workflow Example

Contributing

About Openprovider

Repository

License

About

Resources

Contributing

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages