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

- Source: https://greenhired.com/developers/mcp/other-clients/
- Section: GreenHired developers · MCP server · Connect a client
- Last updated: 2026-11-21

## 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](https://code.visualstudio.com/docs/copilot/customization/mcp-servers), 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:

```bash
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:

```bash
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](https://greenhired.com/developers/mcp/protocol/).

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

## Related pages

- https://greenhired.com/developers/mcp/protocol/
- https://greenhired.com/developers/mcp/authentication/
- https://greenhired.com/developers/mcp/cursor/
