Deploy from your coding agent

Capabilities

What agents can and cannot do

Prerequisites

Before you connect an MCP client

1. AccountInvite-gated sign-up at /register with an NJ-… code.
2. Ready serverAt least one server in ready state — add via dashboard with SSH key or password.
3. GitHub (optional)For private Git deploys, connect GitHub under Integrations.

Quick start

Four steps to agent deploy

1. Create an agent key Integrations → Coding agents. Copy the token and pre-filled mcp.json snippet immediately — shown once.
2. Configure your MCP client Paste the URL and Bearer token into Cursor, Claude Code, or another client — see paths below.
3. Reload the client Restart or reload MCP in your tool's settings. Verify nomorejoel lists deploy tools.
4. Prompt your agent Examples below. The agent calls MCP tools; you answer clarifying questions in chat.

Where to add the server

Use the same URL and Bearer token in whichever client you use. JSON shape below works for Cursor, Claude Desktop, and other mcpServers-style configs.

• Cursor — ~/.cursor/mcp.json or project .cursor/mcp.json
• Claude Code — claude mcp add (HTTP transport) or MCP settings in your project
• Claude Desktop — claude_desktop_config.json → mcpServers
• VS Code / Copilot, Windsurf, Zed, … — MCP panel or config file per your editor's docs

Example mcp.json

{
  "mcpServers": {
    "nomorejoel": {
      "url": "https://www.nomorejoel.com/mcp/",
      "headers": {
        "Authorization": "Bearer sp_your_agent_key_here"
      }
    }
  }
}

Example prompts

• List my servers and projects
• Deploy nginx:1.27-alpine to my ready server with an sslip.io route
• Create a FastAPI app from github.com/org/repo on branch main and deploy it
• Why did my last deploy fail? Use explain_deploy_blockers and deploy logs.
• Show security findings for my production app.
• Create a Postgres database and link it to my API app.

MCP tools

Tool reference

Grouped by category. Add ops scope for alert actions, stack repair, and server diagnostics.

REST

Direct API access

Non-MCP integrations can use the same sp_* tokens against the REST API:

• OpenAPI schema: https://www.nomorejoel.com/openapi.json
• Interactive docs: https://www.nomorejoel.com/docs
• Auth header: Authorization: Bearer sp_…

Security

Keep keys safe

• Agent keys expire after 90 days by default — revoke unused keys in Integrations.
• Never commit keys to git. Use project-local mcp.json in .gitignore or env-based headers.
• Keys are bound to one workspace — they cannot access other tenants.
• Use minimum scopes: read-only keys for inspection, deploy scope only when needed.

Troubleshooting

Common issues