{"_id":"@aiesphere/mcp-connect","_rev":"2-14f5c6adc2580c7d46b3cc2c5f6c1055","name":"@aiesphere/mcp-connect","dist-tags":{"latest":"0.2.0"},"versions":{"0.1.0":{"name":"@aiesphere/mcp-connect","version":"0.1.0","keywords":["mcp","model-context-protocol","aiesphere","jobs","auto-apply"],"author":{"name":"AiESphere"},"license":"MIT","_id":"@aiesphere/mcp-connect@0.1.0","maintainers":[{"name":"aiesphere","email":"admin@aiesphere.com"}],"homepage":"https://aiesphere.com","bin":{"mcp-connect":"bin/cli.mjs","aiesphere-mcp":"bin/cli.mjs"},"dist":{"shasum":"ed9d4fbe109080abddbde47255733e9fee0f27fb","tarball":"https://registry.npmjs.org/@aiesphere/mcp-connect/-/mcp-connect-0.1.0.tgz","fileCount":4,"integrity":"sha512-zx/QQ9wS1mj4UYtwiqaIjbKUuecL6EqzjXihQb0tXjLdqlmZWO7aY5GM5nvjClpH54uzSNPdUGuhy32ivWybuw==","signatures":[{"sig":"MEUCIDVZqLTfdXdeB6l/T/iI9pkXmUojyHYXLTVNvnq4wuj5AiEA3R7M/eMvpRTRHLV4/h+nCx+AOEXJxg3xjJLLXJgPQIg=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":16453},"type":"module","engines":{"node":">=18"},"gitHead":"794e60fba8e0e7130e46b3bdffd7d8e6f859c774","_npmUser":{"name":"aiesphere","email":"admin@aiesphere.com"},"_npmVersion":"11.12.1","description":"One command to connect the AiESphere MCP server to any AI client (Claude, Cursor, Copilot, Codex, opencode, Gemini, Windsurf, Cline, Zed…).","directories":{},"_nodeVersion":"24.15.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/mcp-connect_0.1.0_1783848929337_0.7860366671041257","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"@aiesphere/mcp-connect","version":"0.2.0","description":"One command to connect the AiESphere MCP server to any AI client (Claude, Cursor, Copilot, Codex, opencode, Gemini, Windsurf, Cline, Zed…). Detects what you have installed and lets you pick.","type":"module","bin":{"mcp-connect":"bin/cli.mjs","aiesphere-mcp":"bin/cli.mjs"},"engines":{"node":">=18"},"keywords":["mcp","model-context-protocol","aiesphere","jobs","auto-apply"],"author":{"name":"AiESphere"},"homepage":"https://aiesphere.com","license":"MIT","publishConfig":{"access":"public"},"dependencies":{"@clack/prompts":"^1.7.0","picocolors":"^1.1.1"},"gitHead":"9770707734e2793524355d9a58a371941ef94ef8","_id":"@aiesphere/mcp-connect@0.2.0","_nodeVersion":"24.15.0","_npmVersion":"11.12.1","dist":{"integrity":"sha512-x9XuN7XKk2OVGTVw1ot3DpK1U5MaxtFJx5IAbfzYzaeAkCjPVMtw85UkuFuqmHTaYKZeO49OIgFj9Qpu/GZ/2Q==","shasum":"23c7dde7bef4d02c1f4177ad4204e3efca6e1bd2","tarball":"https://registry.npmjs.org/@aiesphere/mcp-connect/-/mcp-connect-0.2.0.tgz","fileCount":5,"unpackedSize":33116,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQDDoZmsiK8V7VfKBD2P669g78AQ7Dunc2YCDNfbqulOOQIgTBX7Qw4V/hg7XJP2ZbZbOcvyiq4I6HNqSn9jHMUh/gc="}]},"_npmUser":{"name":"aiesphere","email":"admin@aiesphere.com"},"directories":{},"maintainers":[{"name":"aiesphere","email":"admin@aiesphere.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-connect_0.2.0_1786730035212_0.9317125696691382"},"_hasShrinkwrap":false}},"time":{"created":"2026-07-12T09:35:29.255Z","modified":"2026-08-14T17:53:55.477Z","0.1.0":"2026-07-12T09:35:29.474Z","0.2.0":"2026-08-14T17:53:55.342Z"},"author":{"name":"AiESphere"},"license":"MIT","homepage":"https://aiesphere.com","keywords":["mcp","model-context-protocol","aiesphere","jobs","auto-apply"],"description":"One command to connect the AiESphere MCP server to any AI client (Claude, Cursor, Copilot, Codex, opencode, Gemini, Windsurf, Cline, Zed…). Detects what you have installed and lets you pick.","maintainers":[{"name":"aiesphere","email":"admin@aiesphere.com"}],"readme":"# @aiesphere/mcp-connect\n\nConnect the **AiESphere MCP server** to your AI client in one command — so your agent can\nfetch your recommended jobs, tailor your résumé, and one‑click apply, all through the\nplatform's grounded, verified engine.\n\n```bash\nnpx @aiesphere/mcp-connect\n```\n\nIt checks the server is up, works out which AI clients you actually have installed, and opens\nthe picker with those already ticked. Move with `↑ ↓`, toggle with `space` (or `tab`), type to\nfilter, `enter` to confirm. Usually that means pressing `enter` once.\n\nIt then writes the right config for each client you chose, backing up anything it touches, and\npoints them at `https://mcp.aiesphere.com/mcp`. Reopen the client and it opens a browser to sign\nin to AiESphere and approve access (OAuth 2.1).\n\n```\n    ███   █████  █████  █████  ████   █   █  █████  ████   █████\n   █   █    █    █      █      █   █  █   █  █      █   █  █\n   █████    █    ████   █████  ████   █████  ████   ████   ████\n   █   █    █    █          █  █      █   █  █      █  █   █\n   █   █  █████  █████  █████  █      █   █  █████  █   █  █████\n\n   the job-apply backend for any AI agent\n\n┌   aiesphere\n│\n◇  Server  https://mcp.aiesphere.com/mcp\n│\n◇  Reachable  OAuth 2.1 · 13 scopes\n│\n◇  Found on this machine, already selected ─╮\n│  ● Claude Code (CLI)                      │\n│  ● Cursor                                 │\n│  ● Codex (OpenAI CLI)                     │\n├───────────────────────────────────────────╯\n│\n◆  Which clients should connect to AiESphere?\n│  Search: Type to filter…\n│  ◼ Claude Code (CLI)\n│  ◼ Cursor\n│  ◼ Codex (OpenAI CLI)\n│  ◻ Claude Desktop\n│  ◻ VS Code (GitHub Copilot, agent mode)\n│  ↑/↓ to navigate • Space/Tab: select • Enter: confirm • Type: to search\n```\n\nNon‑interactive / scripted:\n\n```bash\nnpx @aiesphere/mcp-connect --all                  # every client found on this machine\nnpx @aiesphere/mcp-connect --client cursor        # write config for one client\nnpx @aiesphere/mcp-connect --client codex --print # just show the config, don't write\nnpx @aiesphere/mcp-connect --list                 # list clients, marking the ones found\n```\n\nFlags: `--client <id>` · `--all` · `--url <url>` · `--name <server>` · `--print` · `--list` · `--help`\n\n## Supported clients\n\n| Client | How it connects |\n|---|---|\n| **Claude Code** | native remote (`claude mcp add --transport http`) or project `.mcp.json` |\n| **Claude Desktop** | `mcp-remote` bridge (OAuth) in `claude_desktop_config.json` |\n| **Cursor** | native remote URL in `~/.cursor/mcp.json` |\n| **VS Code (GitHub Copilot)** | native remote in `.vscode/mcp.json` (or `code --add-mcp`) |\n| **Windsurf** | `serverUrl` in `~/.codeium/windsurf/mcp_config.json` |\n| **Cline** | native `streamableHttp` in `cline_mcp_settings.json` |\n| **Zed** | native remote `url` in `~/.config/zed/settings.json` (Zed runs the OAuth flow) |\n| **opencode** | native `remote` in `~/.config/opencode/opencode.json` |\n| **Codex (OpenAI CLI)** | native remote `url` in `~/.codex/config.toml` (current Codex; older needs `experimental_use_rmcp_client`) |\n| **Gemini CLI** | native `httpUrl` in `~/.gemini/settings.json` |\n| **Anything else** | `npx -y mcp-remote https://mcp.aiesphere.com/mcp` |\n\nBecause AiESphere ships a **standard remote MCP server (Streamable HTTP + OAuth 2.1 with\ndynamic client registration)**, any MCP‑capable client works with the same one URL — no\nper‑client server code. Clients that only speak stdio (or don't do OAuth themselves) use the\nwidely‑used **`mcp-remote`** bridge, which runs the OAuth browser flow and proxies it to stdio.\n\n## Manual (any client)\n\nNative remote (Cursor / VS Code / opencode / Gemini CLI / Claude Code):\n\n```json\n{ \"mcpServers\": { \"aiesphere\": { \"url\": \"https://mcp.aiesphere.com/mcp\" } } }\n```\n\nStdio bridge (Claude Desktop / Codex / Zed / anything):\n\n```json\n{ \"mcpServers\": { \"aiesphere\": { \"command\": \"npx\", \"args\": [\"-y\", \"mcp-remote\", \"https://mcp.aiesphere.com/mcp\"] } } }\n```\n\n## What you can do once connected\n\n**Tools**\n\n| Area | Tools |\n|---|---|\n| Jobs | `list_recommended_jobs` · `search_jobs` · `get_job` · `get_apply_eligibility` · `save_job` · `dismiss_job` |\n| Profile | `get_profile` · `list_resumes` · `get_apply_profile` · `update_apply_profile` |\n| Applications | `list_applications` · `list_apply_runs` · `get_apply_status` · `update_application_status` · `add_application_note` · `archive_application` |\n| Applying | `apply_to_job` · `confirm_submit` |\n| Documents | `preview_tailoring` · `generate_cover_letter` |\n| Connectivity | `ping` |\n\nReads are annotated read-only so most clients run them without prompting. `apply_to_job` and\n`confirm_submit` are annotated **destructive** — they file a real application in your name.\n\n**Resources** — `profile://me` · `resumes://list` · `applications://board`, for pinning your own\nstate into a conversation instead of re-fetching it.\n\n**Prompts** (slash commands in most clients) — `apply-to-best-matches` · `tailor-for-job` ·\n`review-pipeline` · `unstick-apply-run`.\n\n### Applying end to end\n\n`apply_to_job` returns a `runId` immediately. Pass `wait: true` to follow the run instead: it\nstreams MCP progress notifications, and if the application stalls on a screening question the\nengine won't guess at, it asks you through your client (elicitation) and finishes the submission.\nClients without elicitation support get the outstanding questions back and can answer them with\n`confirm_submit(runId, answers)`.\n\nRésumé tailoring and cover letters are always generated **server-side**, grounded in your résumé\nand the job description and checked against fabrication. The connected model steers; it never\nwrites the document that gets submitted.\n\n## Scopes\n\n`jobs.read` · `jobs.write` · `profile.read` · `profile.write` · `applications.read` ·\n`applications.write` · `resume.tailor` · `cover.generate` · `apply.submit`\n\nA client that requests no scopes gets read-only access. Writing, tailoring and — especially —\n`apply.submit` must be requested explicitly, and the consent screen lists exactly what was asked\nfor before you approve. Revoke any agent any time from **Settings → Connected apps**.\n\n## Developing against a local server\n\n```bash\nnpm run dev:next     # the MCP endpoint is served at http://localhost:3000/mcp\nnpx tsx --env-file=.env scripts/mcp-server/verify-tools.mts          # surface + gate checks\nnpx tsx scripts/mcp-server/verify-client-matrix.mts http://localhost:3000/mcp\n```\n\nThe repo's own `.mcp.json` points at the local endpoint, so Claude Code picks the server up from\nthe project root. The flow is OAuth, so there is nothing secret in that file.\n\n> Config formats track each client's current docs and can shift between versions. If a client\n> updates its schema, run with `--print` and paste the snippet, or use the `mcp-remote` bridge.\n","readmeFilename":"README.md"}