Spec Driven Development
MCP Server that facilitates spec-driven development workflows, not just Vibe Coding.
Description from the maker (original English)
Run AI interviews, simulated personas and coaching sessions on JobMojito.
These three are never merged into one score: opinions, measurements and popularity are different things.
We have not written a plain-language summary for this one yet. Below are the facts we read from the registry.
Pick the AI app you use, then copy the settings.
You need
Which app do you use?
Pick your app above. We remember it, so next time the button says “Install in …”.
Works in Claude on the web, desktop and mobile:
https://mcp.jobmojito.com/mcpRun this in your terminal
claude mcp add --transport http jobmojito https://mcp.jobmojito.com/mcpPaste into .cursor/mcp.json in your project, or ~/.cursor/mcp.json
{
"mcpServers": {
"jobmojito": {
"url": "https://mcp.jobmojito.com/mcp"
}
}
}Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.
Paste into .vscode/mcp.json in your project
{
"servers": {
"jobmojito": {
"type": "http",
"url": "https://mcp.jobmojito.com/mcp"
}
}
}Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.
ChatGPT connects only to servers on the internet:
https://mcp.jobmojito.com/mcpMenu names can differ slightly by plan and over time.
Your choice stays on this device in a cookie; no account needed.
These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.
We have not read this server’s tool list yet; we check endpoints in rotation.
We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 7, 2026
The registry name was verified against the domain jobmojito.com (the registry checks domain ownership)
We have not read this repo from GitHub yet
We have not read this repo from GitHub yet
Responded in 675 ms (HTTP 200)
No sign-in needed
Not checked yet; we read the tool list when we check the endpoint
Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.
It passed 2 of 2 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.
The registry does not list a required key, though some servers ask you to sign in on first use.
It runs in the maker’s cloud. Connect over the internet with nothing to install, but what you send passes through the maker’s servers.
The GitHub repo last changed –, and the latest version (1.5.0) reached the registry 3 days ago.
Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. It connects by URL, so apps that accept remote MCP servers work too, such as ChatGPT in developer mode.
In the same category: Spec Driven Development, Remote Desktop Commander, FlyDocs
Servers in the same category from other makers, sorted by stars.
Reading a card:★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi
MCP Server that facilitates spec-driven development workflows, not just Vibe Coding.
Remote Desktop Commander: use files, terminal and processes on your own computers from any AI app.
Spec-driven development workflow: your agent works issues, sessions and the status lifecycle.
Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.
JobMojito runs AI-led conversational sessions in three shapes. The difference between them matters, because one tool builds two of them:
The one trap.
create_personabuilds both the second and the third product,
selected by its
portalargument — and it defaults to `coaching`. For
anything used to assess or screen, pass
portal="interview"explicitly, or you
silently get the wrong product: billed to the wrong credits and invisible to the
recruiter.
Across all three: register candidates in bulk and give each a personal link, upload documents to a knowledge base the AI draws on, read back transcripts, structured analysis and shareable HTML or PDF reports, and manage workspaces, credits and analytics across merchants and sub-merchants.
Everything the platform produces is decision support for a qualified human reviewer — never the hiring decision itself, and candidates are told AI is part of the process.
Around the product: the admin console at app.jobmojito.com, developer/API docs at developer.jobmojito.com, the help center at help.jobmojito.com, and the hosted MCP endpoint this repo powers at https://mcp.jobmojito.com/mcp.
This repository is the MCP server that puts all of that into AI assistants like Claude and ChatGPT.
An MCP server for the JobMojito API, built with FastMCP and designed to deploy on Prefect Horizon (the MCP platform from the FastMCP team — app.prefect.cloud → Horizon).
It exposes:
GET lists — are surfaced as tools with clean, curated names, each with a title and read-only/destructive annotations.search_documentation, get_documentation) that read the developer docs and help center live — docs stay single-source on their existing platforms; nothing is copied into this repo.MCP client (Claude / ChatGPT)
│ OAuth login (Supabase OAuth Server, DCR) ▼ JobMojito MCP server (this repo, on Horizon) │ forwards the user's Supabase JWT ▼ JobMojito API (https://cool.jobmojito.com/functions/v1)
| Concern | Approach |
|---|---|
| API → tools | FastMCP.from_openapi(...), all routes mapped to Tools, curated names via injected operationIds |
| Spec freshness | Fetched live at startup; a runtime cache + committed snapshot are fallbacks |
| Auth | SupabaseProvider (Remote OAuth); per-request JWT forwarding to the upstream API |
| Docs | Built-in tools reading developer.jobmojito.com/llms.txt + .md and the help.jobmojito.com (Featurebase) help center |
| File | Purpose |
|---|---|
server.py | Entry point — builds and exposes mcp (point Horizon at server.py:mcp) |
config.py | Environment-driven settings |
openapi_loader.py | Live fetch + cache/snapshot fallback + operationId injection |
naming.py | Curated tool names, titles, hints and annotations per endpoint |
upstream.py | httpx client that forwards the user's Supabase JWT to the API |
middleware.py | Call logging, upstream-error rewriting, result-size guard, annotation backfill |
merchants.py | Merchant picker (MCP App UI) + list_my_merchants text fallback |
docs_tools.py | search_documentation / get_documentation |
featurebase.py | Featurebase REST client (help-center articles) |
mintlify.py | Mintlify developer-docs MCP proxy + client-credentials auth |
tests/ | test_smoke.py (inventory, schema relaxation, docs) + test_listing_readiness.py (directory contract) |
docs/ | Developer docs: architecture, development, deployment |
scripts/update_snapshot.py | Refresh the committed fallback spec |
scripts/try_docs.py | Local smoke test for the documentation tools |
data/openapi.snapshot.json | Offline fallback spec (regenerate from your machine) |
lazy_auth.py | Unauthenticated capability discovery + scope= on the 401 challenge |
wellknown.py | /healthz, OpenAI domain challenge, Smithery server card |
server.json | Official MCP Registry entry |
.github/workflows/publish-registry.yml | Publishes server.json to the MCP Registry when a push to main changes server.py:SERVER_VERSION (or via manual dispatch) |
# 1. Set up a virtualenv and install deps
python3 -m venv .venv && source .venv/bin/activate pip install -r requirements.txt
cp .env.example .env # then fill in your keys/credentials
fastmcp inspect server.py:mcp
ENABLE_AUTH=false pytest -q --asyncio-mode=auto
ENABLE_AUTH=false python scripts/try_docs.py "how do I create an interview"
ENABLE_AUTH=false python server.py # → http://localhost:8000/mcp
npx @modelcontextprotocol/inspector
Testing notes:
search_documentation, and the mounted Mintlify search_*_developer_* / query_docs_filesystem_*) work with ENABLE_AUTH=false — no Supabase login needed. scripts/try_docs.py is the fastest check.create_interview, list_candidates, …) call the real JobMojito API and need a Supabase user token. For local testing, set JOBMOJITO_DEV_BEARER_TOKEN in .env to a valid Supabase access token; it's forwarded when ENABLE_AUTH=false. (Never set this in production — there the token comes from the user's OAuth session.)ENABLE_AUTH=true, set BASE_URL=http://localhost:8000, and connect a client that supports OAuth (it will bounce you through Supabase).Refresh the fallback snapshot from a network that can reach the API:
python scripts/update_snapshot.py(the committed snapshot in this repo is a
thin structural fallback; this replaces it with the full live spec).
This server uses Supabase's OAuth Server feature (which supports Dynamic Client Registration, so MCP clients self-register). The MCP server is the OAuth resource server — it validates tokens; Supabase issues them.
Project: https://momsbvnltsydezmoesqt.supabase.co SupabaseProvider derives every endpoint from this project URL:
| Endpoint | URL |
|---|---|
| Authorize | …/auth/v1/oauth/authorize |
| Token | …/auth/v1/oauth/token |
| JWKS | …/auth/v1/.well-known/jwks.json |
| OIDC discovery | …/auth/v1/.well-known/openid-configuration |
Steps:
https://app.jobmojito.com/oauth/consentSUPABASE_PROJECT_URL=https://momsbvnltsydezmoesqt.supabase.co, BASE_URL=https://mcp.jobmojito.com (public base, no /mcp), SUPABASE_JWT_ALGORITHM=ES256 (switch to RS256 if your JWKS shows RSA keys).apikey header, set SUPABASE_ANON_KEY.Consent is handled by Supabase / your app, not this server. Because the Site URL is app.jobmojito.com, Supabase serves the approve/deny screen at https://app.jobmojito.com/oauth/consent, where the user already has a Supabase session. This MCP server is only the OAuth resource server — it does not serve a consent page. SITE_URL and OAUTH_CONSENT_PATH are informational and should match your Supabase OAuth Server settings.
Token note:
SupabaseProvidercannot validate token *audience* (Supabase Auth
doesn't implement RFC 8707 resource indicators yet). This is expected and
logged at startup.
**Every tool *call* requires the user to be signed in via Supabase OAuth** — including search_documentation and get_documentation. Keep ENABLE_AUTH=true; the signed-in user's token is forwarded to the JobMojito API so calls respect that user's permissions.
The one deliberate exception is capability discovery: with ENABLE_LAZY_AUTH (default true), initialize, ping and the */list methods answer without a token so directory crawlers can render the tool list. No data is reachable that way — every tools/call, resource read and prompt still needs a verified JWT.
server.py:mcprequirements.txtENABLE_AUTH=trueBASE_URL=https://mcp.jobmojito.com — critical. This must be the server's public base URL, with no `/mcp` and no trailing slash. It's what SupabaseProvider advertises as the OAuth resource; if it's left at the http://localhost:8000 default, clients get 401 invalid_token. The startup log prints base_url=… and warns if it's localhost.SUPABASE_PROJECT_URL=https://momsbvnltsydezmoesqt.supabase.coSUPABASE_ANON_KEY if the Edge Functions need the apikey header.FEATUREBASE_API_KEY for help-center docs.https://mcp.jobmojito.com/mcp. Horizon redeploys on every push to main.A 401 on initialize is the normal first step of MCP OAuth — the client is meant to read the discovery metadata and run the Supabase login. Horizon's Inspector / ChatMCP do not perform that login, so they'll show a bare 401. Test by adding https://mcp.jobmojito.com/mcp as a custom connector in Claude.ai, which runs the full OAuth flow and prompts the Supabase login.
Make sure the Supabase side is configured (or the flow 401s regardless): OAuth Server enabled + Dynamic Client Registration on; Site URL https://app.jobmojito.com
Only the beginning is shown; read the rest in the repo