Nextrole MCP Proxy

What nextrole-mcp-proxy MCP server does

The nextrole-mcp-proxy MCP server exposes NextRole's professional CV and cover letter tailoring service to MCP clients. It supports three service operations: retrieving available pricing tiers, checking a customer's remaining credits, and submitting an order for a tailored CV and cover letter.

Pricing results include a country code, service tier, and product ID. The documented tiers are Entry Level, Mid Level, and Senior Level, with product IDs 1, 2, and 3 respectively. The product ID should be selected before an order is submitted.

How it works

The proxy forwards MCP protocol requests to NextRole's hosted service at https://api.nextrole.co.za/firstroleprod-mcp/mcp. It translates requests from the MCP client, sends them to the remote service, formats the returned data, and reports connection or service errors back to the client.

A typical order flow starts with get_pricing, followed by get_credits if the customer's balance needs to be checked. place_order then submits the customer's phone number, first and last names, current CV in Markdown, selected product ID, and complete job description. Each order uses one credit and generally takes about 15 minutes. The customer receives SMS notifications when the order is confirmed and when the documents are ready.

Setup and configuration

The repository requires Node.js 18 or newer and an internet connection to reach NextRole's hosted service. To install from source, clone the repository and run bash install.sh on Linux or macOS, or install.ps1 in PowerShell on Windows. The installation script installs dependencies, builds the project, and prints MCP client configuration containing the local executable path.

A local installation is not required when the client supports npx. Add a server entry using the nextrole-mcp-proxy package as the command:

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

No environment variables are documented for configuration. Development commands include npm run build, npm run dev, and npm start.

Tools and capabilities

The documented operations are:

• get_pricing: Lists career-level service tiers and their product IDs.
• get_credits: Returns the remaining credits for a phone number that includes its country code.
• place_order: Submits a CV tailoring and cover letter request. Required data includes customerPhone, customerFirstName, customerLastName, cvMarkdown, productId, and jobDescription.

The phone number for credit checks must include a country code. The order phone number must begin with +. The available tool parameter names include phoneNumber, customerPhone, customerFirstName, customerLastName, cvMarkdown, productId, and jobDescription.

Limitations and notes

The nextrole-mcp-proxy MCP server depends on NextRole's hosted endpoint, so it cannot operate without network access to that service. It submits customer contact information, CV content, and job descriptions to NextRole; users should review NextRole's privacy policy and terms of service before use.

The README describes the proxy and service behavior but does not document local processing, offline operation, custom endpoint configuration, or additional authentication settings. Service-related questions should be directed to NextRole through its official support channels, while proxy issues can be reported in the repository's GitHub issues.