# Gupy MCP by usefulapi

> Gupy MCP by usefulapi is a freemium MCP server for hiring and recruiting. Hosted MCP connector to read Gupy jobs, application summaries and hiring steps. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $9 a month
- **Platforms:** API, Web
- **Website:** https://usefulapi.io/gupy/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/gupy
- **MCP Registry name:** io.usefulapi/gupy
- **Categories:** hiring and recruiting
- **Listing updated:** 2026-11-18

## About

The README describes this as a hosted remote server, so there is nothing to install locally. Once connected from an AI client, it reads job summaries, application summaries and recruitment steps from the Gupy account behind your own API token. Access is read-only: the three Gupy tools are marked as such, and the site says identity documents, medical data and automated hiring decisions are excluded from what it requests.

Connection uses OAuth. You add only the server URL to the client, then sign in on a login page with a recruitment API token from a Gupy Premium or Enterprise account. The site says the server stores those credentials encrypted and calls the Gupy API on your behalf, and that it sees only the data your account can access.

The server is aimed at recruiters and hiring teams who want to review jobs and candidate pipelines through a chat assistant. It is an independent service run by usefulapi and is not affiliated with or endorsed by Gupy.

## Features

- **Read job summaries:** Lists job summaries from your Gupy recruitment account so you can pick one to review.
- **Application summaries per job:** Returns basic candidate names and application or step IDs for a chosen job.
- **Recruitment step overview:** Shows the steps configured for a job so a hiring team can review the process.
- **Read-only access:** All three Gupy tools are marked read-only, so the assistant cannot change Gupy data.
- **Hosted OAuth connection:** Connects from Claude, ChatGPT, Cursor, VS Code and other remote MCP clients without local installation.
- **Usage metering tools:** Includes tools to check usage and manage a paid plan.

## Good for

- Pick which open jobs to review in a chat with an AI assistant
- Summarize the applications for one job without opening Gupy
- Check how applications are distributed across a job's recruitment steps
- Summarize the configured recruitment steps for a hiring team

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http gupy https://gupy.usefulapi.io/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://gupy.usefulapi.io/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "gupy": {
      "url": "https://gupy.usefulapi.io/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "gupy": {
      "type": "http",
      "url": "https://gupy.usefulapi.io/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "gupy": {
      "serverUrl": "https://gupy.usefulapi.io/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "gupy": {
      "type": "http",
      "url": "https://gupy.usefulapi.io/mcp"
    }
  }
}
```

## Tools

- `gupy_list_jobs`: Read job summaries for your own Gupy recruitment account.
- `gupy_list_applications`: Read application summaries for a job, with basic candidate names and application/step IDs.
- `gupy_list_steps`: Read the recruitment steps configured for one job.
- `gupy_usage_status`: Report the caller's current usage and plan limits.
- `gupy_request_feature`: Send a request to usefulapi for a feature the Gupy tools cannot yet provide.
- `gupy_upgrade`: Get a paid plan for Gupy (Pro or Pro+).
- `gupy_cancel_subscription`: Cancel the Gupy Pro subscription at the end of the paid period.

## FAQ

### What can I do with Gupy in Claude or ChatGPT?

List job summaries, review application summaries for one job, see the recruitment steps of one job, and map applications to recruitment steps.

### Is this an official Gupy product?

No. usefulapi is an independent service and is not affiliated with or endorsed by Gupy.

### What does it cost?

The Free plan gives 50 tool calls per month. Pro costs $9/mo or $90/yr with 10,000 calls per month. Pro+ costs $39/mo or $390/yr with 100,000 calls per month.

### Can the AI change my Gupy data?

No. The site says all 3 Gupy tools are marked read-only.

### Is Gupy MCP by usefulapi free?

Gupy MCP by usefulapi has a free plan, with paid plans for more usage or features. Paid plans start at $9 a month.

### How do I add Gupy MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http gupy https://gupy.usefulapi.io/mcp

### What are the best alternatives to Gupy MCP by usefulapi?

The closest alternatives to Gupy MCP by usefulapi are Reactive Resume, OnlineJobs.ph Scraper (Apify) - Philippine remote and VA jobs with wages, Gupy Jobs Scraper (Apify) - Brazil jobs with descriptions, Y Combinator Jobs Scraper & API - Work at a Startup, YC Jobs and Workable Jobs Scraper & API - All Companies, Remote, 24 Hours.

## Where this comes from

- Description: written from the project's README, the project's website and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Reactive Resume](https://ai-powered.com/mcp/reactive-resume): Reactive Resume is an open-source MCP server for hiring and recruiting.
- [OnlineJobs.ph Scraper (Apify) - Philippine remote and VA jobs with wages](https://ai-powered.com/mcp/onlinejobs-ph-scraper-apify-philippine-remote-and-va-jobs-wi): OnlineJobs.ph Scraper (Apify) - Philippine remote and VA jobs with wages is a paid MCP server for web search and scraping.
- [Gupy Jobs Scraper (Apify) - Brazil jobs with descriptions](https://ai-powered.com/mcp/gupy-jobs-scraper-apify-brazil-jobs-with-descriptions): Gupy Jobs Scraper (Apify) - Brazil jobs with descriptions is a freemium MCP server for web search and scraping.
- [Y Combinator Jobs Scraper & API - Work at a Startup, YC Jobs](https://ai-powered.com/mcp/y-combinator-jobs-scraper-and-api-work-at-a-startup-yc-jobs): Y Combinator Jobs Scraper & API - Work at a Startup, YC Jobs is a freemium MCP server for web search and scraping.
- [Workable Jobs Scraper & API - All Companies, Remote, 24 Hours](https://ai-powered.com/mcp/workable-jobs-scraper-and-api-all-companies-remote-24-hours): Workable Jobs Scraper & API - All Companies, Remote, 24 Hours is a freemium MCP server for web search and scraping.
- [Lever Jobs Scraper & API - Salary, Remote, Last 24 Hours](https://ai-powered.com/mcp/lever-jobs-scraper-and-api-salary-remote-last-24-hours): Lever Jobs Scraper & API - Salary, Remote, Last 24 Hours is a paid MCP server for web search and scraping.
- [Workday Jobs Scraper & API - All Companies, Last 24 Hours](https://ai-powered.com/mcp/workday-jobs-scraper-and-api-all-companies-last-24-hours): Workday Jobs Scraper & API - All Companies, Last 24 Hours is a freemium MCP server for web search and scraping.
- [HeyRole](https://ai-powered.com/mcp/heyrole): HeyRole is a free MCP server for hiring and recruiting.

---
Source: https://ai-powered.com/mcp/gupy-mcp-by-usefulapi
