jobnimbus

This MCP server exposes JobNimbus data and operations to compatible AI assistants through the MCP (Model Context Protocol). It provides tools to list, retrieve, create, and update JobNimbus entities such as Contacts, Jobs, Tasks, Products, Workflows, and Invoices. Agents using Cursor or Claude can discover these tools and invoke them to perform actions like listing contacts, creating a new job, updating a task, or sending an invoice. The server authenticates requests using your JobNimbus API key provided via the JOBNIMBUS_API_KEY environment variable, and exposes a standardized set of tool names (e.g., jobnimbus_list_contacts, jobnimbus_get_contact, jobnimbus_create_job, jobnimbus_update_invoice, etc.). When running through npx, the assistant will automatically download the latest version of the server package if needed and pass the API key to the process.

Prerequisites:

• Node.js and npm installed
• A JobNimbus API key

Step-by-step:

1. Install Node.js and npm from the official sources if not already installed.
2. Ensure you have your JobNimbus API key ready.
3. Install the MCP server package (via npx) or install locally for development:
   • For runtime usage with MCP clients: no local installation is required; the server runs through npx as described in the README.
   • For development: clone the repository, install dependencies, and run locally.
4. If developing locally:
   • cd jobnimbus-mcp-server
   • npm install
   • Create a .env file or export the API key: export JOBNIMBUS_API_KEY=your_actual_api_key_here
   • Start the server for testing: npm start or npm run dev
5. Verify with MCP clients (Cursor, Claude) using the provided npx configuration to ensure the server is reachable and that tools are exposed.

Tips and common issues:

• Always keep your API key secure and avoid committing it to version control.
• When using npx, ensure your environment has network access to fetch the latest package version.
• If a tool is not appearing in the MCP tool list, verify the JOBNIMBUS_API_KEY is correctly provided in the env and that the server is reachable by the client.
• The server supports standard MCP tools for Contacts, Jobs, Tasks, Products, Workflows, and Invoices; refer to the README for the exact tool names and capabilities.
• For troubleshooting, run the server manually (npx jobnimbus-mcp-server) to view logs and confirm it is listening for stdin/stdout communication.