{
  "markdown": "# NextRole MCP Proxy\n\nA 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.\n\n## Features\n\n- **Professional CV Tailoring**: Customize your CV for specific job applications\n- **Cover Letter Generation**: Create tailored cover letters that match job requirements  \n- **Multiple Service Tiers**: Entry, Mid, and Senior level professional services\n- **Credit Management**: Track and manage your service credits\n- **International Support**: Available for users worldwide\n\n## Installation\n\n### From source\n\nClone the repository and run the install script. It will install dependencies, build the project, and print the MCP client configuration JSON for you.\n\n```bash\ngit clone https://github.com/bats64mgutsi/nextrole-mcp-proxy.git\ncd nextrole-mcp-proxy\n```\n\n**Linux / macOS:**\n```bash\nbash install.sh\n```\n\n**Windows (PowerShell):**\n```powershell\n.\\install.ps1\n```\n\nAt 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.\n\n### With npx (no local install)\n\nAdd to your MCP client configuration:\n\n```json\n{\n  \"mcpServers\": {\n    \"nextrole\": {\n      \"command\": \"npx\",\n      \"args\": [\"nextrole-mcp-proxy\"]\n    }\n  }\n}\n```\n\n## Usage\n\n### Available Tools\n\n#### 1. get_pricing\nGet the available career-level tiers and their product IDs. You must call this before placing an order to get the correct `productId`.\n\n**Usage:**\n```\nWhat are your different CV tailoring packages?\n```\n\n**Response:**\n```json\n[\n  {\n    \"CountryCode\": \"ZA\", \n    \"ServiceTier\": \"Entry Level\",\n    \"ProductId\": 1\n  },\n  {\n    \"CountryCode\": \"ZA\",\n    \"ServiceTier\": \"Mid Level\", \n    \"ProductId\": 2\n  },\n  {\n    \"CountryCode\": \"ZA\",\n    \"ServiceTier\": \"Senior Level\",\n    \"ProductId\": 3\n  }\n]\n```\n\n#### 2. get_credits\nCheck how many credits a customer has remaining. Each order costs 1 credit.\n\n**Parameters:**\n- `phoneNumber` (required): Customer phone number including country code (e.g. +27831234567)\n\n**Usage:**\n```\nHow many credits do I have left? My phone number is +27831234567\n```\n\n**Response:**\n```json\n{\n  \"credits\": 5\n}\n```\n\n#### 3. place_order\nPlace 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.\n\n**Parameters:**\n- `customerPhone` (required): Customer phone number including country code, must start with '+' (e.g. +27831234567)\n- `customerFirstName` (required): Customer's first name\n- `customerLastName` (required): Customer's last name\n- `cvMarkdown` (required): The customer's current CV in markdown format\n- `productId` (required): The product ID matching the customer's career level (call get_pricing first)\n- `jobDescription` (required): The full job description the customer is applying for\n\n**Usage:**\n```\nI 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:\n\n# John Smith\n## Experience\n- Junior Developer at TechCorp (2023-present)\n\nThe job description is: We are seeking a Junior Software Developer to join our team with React and Node.js experience.\n```\n\n**Response:**\n```json\n{\n  \"orderKey\": \"550e8400-e29b-41d4-a716-446655440000\",\n  \"status\": \"success\",\n  \"message\": \"Order placed successfully. SMS notifications sent.\"\n}\n```\n\n## Example Use Cases\n\n### Entry Level Professional\nPerfect for recent graduates and early-career professionals:\n\n```\nI'm Sarah Johnson (+44207123456) and need my CV tailored for this graduate software engineer role: Graduate Software Engineer requiring Python programming and problem-solving skills. \n\nMy current CV:\n# Sarah Johnson\n## Education\n- Computer Science Degree, University of London (2024)\n## Projects  \n- Built a web application using Python and Flask\n```\n\n### Career Change\nFor professionals transitioning between industries:\n\n```\nI'm transitioning from finance to tech and need my CV (+27831112233, Jane Doe) tailored for this software developer role: Full Stack Developer position requiring JavaScript, React, and database skills.\n\nCurrent CV:\n# Jane Doe\n## Background\n- Financial Analyst at Bank Corp\n- Recently completed coding bootcamp\n```\n\n### Senior Executive\nFor C-level and senior management positions:\n\n```\nI'm Michael Chen from the US (+1555123456) and need my executive CV customized for this CTO role: Chief Technology Officer requiring strategic leadership and team management skills.\n\nMy current CV:\n# Michael Chen\n## Executive Summary\nSenior Technology Leader with 15+ years experience\n## Experience\n- VP Engineering at Tech Startup (2020-2024)\n```\n\n## Service Tiers\n\n- **Entry Level (Product ID: 1)**: For recent graduates and early-career professionals\n- **Mid Level (Product ID: 2)**: For experienced professionals with 3-10 years experience  \n- **Senior Level (Product ID: 3)**: For senior professionals, managers, and executives\n\n## Privacy & Terms\n\nBy using this service, you agree to NextRole's:\n- [Privacy Policy](https://api.nextrole.co.za/firstroleprod-mcp/docs/privacy-policy)\n- [Terms of Service](https://api.nextrole.co.za/firstroleprod-mcp/docs/terms-of-service)\n\n## Development\n\n### Building\n```bash\nnpm run build\n```\n\n### Running in development\n```bash\nnpm run dev\n```\n\n### Testing locally\n```bash\nnpm start\n```\n\n## Architecture\n\nThis is a lightweight proxy that forwards MCP requests to NextRole's hosted service at `https://api.nextrole.co.za/firstroleprod-mcp/mcp`. The proxy:\n\n- Translates MCP protocol requests\n- Forwards them to the hosted service\n- Returns formatted responses to MCP clients\n- Handles errors and connection issues\n\n## Requirements\n\n- Node.js 18.0.0 or higher\n- Internet connection to reach NextRole's hosted service\n\n## License\n\nMIT License - see LICENSE file for details.\n\n## Support\n\nFor technical issues with this proxy, please open an issue on GitHub.\nFor service-related questions, contact NextRole support through their official channels.",
  "bytes": 6195,
  "sha": "f37883059cc0b2e12b07a4a140658413e1d4dba6c6e8ebd4b45832c92318717c",
  "repo_slug": "bats64mgutsi/nextrole-mcp-proxy",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_bats64mgutsi_nextrole_mcp_prox_521f1e87/readme"
}