Next Role Mcp Proxy

by bats64mgutsi

258 downloads
Not rated
GitHub

About

MCP proxy server for NextRole CV tailoring services

Details

Author
bats64mgutsi
Downloads
258
Categories
Other

- Professional CV tailoring for specific job applications
- Cover letter generation matched to job requirements
- Three service tiers: Entry, Mid, and Senior Level
- Credit‑based ordering with balance checking
- Worldwide availability with SMS order notifications

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Next Role Mcp Proxy
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Install it from source or with npx, then add the MCP client configuration to your client’s config file. The server exposes three tools: get_pricing (list service tiers and product IDs), get_credits (check remaining credits by phone number), and place_order (submit a tailoring request with CV, job description, and product ID). Each order consumes one credit and completes in about 15 minutes.

get_pricing

Get the available career-level tiers and their product IDs. Different products are designed for different career phases, so the customer should pick the tier that best matches where they are in their career. You must call this before placing an order to get the correct productId.

get_credits

Check how many credits a customer has remaining. Each order to tailor a CV and cover letter costs 1 credit.

place_order

Place an order for a tailored CV and cover letter. The order typically takes about 15 minutes to complete. The customer will receive an SMS confirming their order and another SMS when their documents are ready to download. Costs 1 credit per order.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "next role mcp proxy": {
            "nextrole": {
                "command": "npx",
                "args": [
                    "nextrole-mcp-proxy"
                ]
            }
        }
    }
}

McpServers

{
    "nextrole": {
        "command": "npx",
        "args": [
            "nextrole-mcp-proxy"
        ]
    }
}

NextRole MCP Proxy

A Model Context Protocol (MCP) proxy server that provides access to NextRole's professional CV and cover letter tailoring services. This proxy allows MCP-compatible clients to interact with NextRole's hosted services.

Features

- Professional CV Tailoring: Customize your CV for specific job applications
- Cover Letter Generation: Create tailored cover letters that match job requirements
- Multiple Service Tiers: Entry, Mid, and Senior level professional services
- Credit Management: Track and manage your service credits
- International Support: Available for users worldwide

Installation

From source

Clone the repository and run the install script. It will install dependencies, build the project, and print the MCP client configuration JSON for you.

git clone https://github.com/bats64mgutsi/nextrole-mcp-proxy.git
cd nextrole-mcp-proxy

Linux / macOS:

bash install.sh

Windows (PowerShell):

.\install.ps1

At the end of the script, you'll see the MCP client configuration JSON with the correct path to your local installation. Copy it into your MCP client's configuration file.

With npx (no local install)

Add to your MCP client configuration:

{
  "mcpServers": {
    "nextrole": {
      "command": "npx",
      "args": ["nextrole-mcp-proxy"]
    }
  }
}

Usage

Available Tools

1. get_pricing

Get the available career-level tiers and their product IDs. You must call this before placing an order to get the correct productId.

Usage:

What are your different CV tailoring packages?

Response:

[
{
"CountryCode": "ZA",
"ServiceTier": "Entry Level",
"ProductId": 1
},
{
"CountryCode": "ZA",
"ServiceTier": "Mid Level",
"ProductId": 2
},
{
"CountryCode": "ZA",
"ServiceTier": "Senior Level",
"ProductId": 3
}
]

2. get_credits

Check how many credits a customer has remaining. Each order costs 1 credit.

Parameters:
- phoneNumber (required): Customer phone number including country code (e.g. +27831234567)

Usage:

How many credits do I have left? My phone number is +27831234567

Response:

{
"credits": 5
}

3. place_order

Place an order for a tailored CV and cover letter. The order typically takes about 15 minutes to complete. The customer will receive SMS notifications when the order is confirmed and when documents are ready. Costs 1 credit per order.

Parameters:
- customerPhone (required): Customer phone number including country code, must start with '+' (e.g. +27831234567)
- customerFirstName (required): Customer's first name
- customerLastName (required): Customer's last name
- cvMarkdown (required): The customer's current CV in markdown format
- productId (required): The product ID matching the customer's career level (call get_pricing first)
- jobDescription (required): The full job description the customer is applying for

Usage:
```
I need to tailor my CV for a Junior Software Developer position. My phone number is +27831234567, my name is John Smith, and here's my current CV in markdown:

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.