VS Code, MCP Inspector and other clients
Any MCP client that supports a remote Streamable HTTP server works with GreenHired. Notes for VS Code, MCP Inspector and a raw JSON-RPC test with curl.
On this page
#What a client needs
GreenHired works with any MCP client that can talk to a remote server over Streamable HTTP at https://mcp.greenhired.com/mcp. For account tools the client also needs OAuth 2.1 with PKCE and dynamic client registration. For the job search tools alone, it needs to send an Authorization header with a ghk_ key.
#VS Code
VS Code adds MCP servers from its chat customization view: choose MCP Servers, add a server, pick HTTP, and enter https://mcp.greenhired.com/mcp. Sign in when it asks. VS Code's file format for MCP servers is changing, so follow Microsoft's page rather than a snippet copied from here: Add and use MCP servers in VS Code, read on 21 November 2026.
#MCP Inspector
The official MCP Inspector is the quickest way to see GreenHired's tools and try a call by hand. This lists the tools with a key:
npx @modelcontextprotocol/inspector --cli \
--server-url https://mcp.greenhired.com/mcp \
--transport http \
--header "Authorization: Bearer $GREENHIRED_API_KEY" \
--method tools/list The flags come from the Inspector's README, read on 21 November 2026. Run it without --cli for the web interface, where Server Settings has an Authorization section for OAuth.
#Raw JSON-RPC with curl
The server is stateless: one JSON-RPC 2.0 message per POST, one JSON answer. Call a tool:
curl -s https://mcp.greenhired.com/mcp \
-H "Authorization: Bearer $GREENHIRED_API_KEY" \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"list_categories","arguments":{}}}' Details of errors and limits are in Protocol notes.
#Frequently asked questions
- Does it support server-sent events?
- No. It is stateless:
GET /mcpanswers405because there is no stream to open. Each request is onePOSTwith one JSON answer. - My client only supports stdio. Can I still use it?
- Use a bridge that connects a stdio client to a remote HTTP server. GreenHired does not ship one.
- Can I test without signing in?
- Not against the real tools. With no credential every call is a
401that tells a client how to sign in. Use aghk_key, or sign in through a client.
Was this page helpful?