MCP server · Connect a client

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.

1 min read Updated Maintained by the GreenHired team
View Markdown
On this page
  1. What a client needs
  2. VS Code
  3. MCP Inspector
  4. Raw JSON-RPC with curl
  5. Frequently asked questions

#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:

curl
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
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 /mcp answers 405 because there is no stream to open. Each request is one POST with 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 401 that tells a client how to sign in. Use a ghk_ key, or sign in through a client.