# UGT: Use the Geek Thing

> UGT: Use the Geek Thing is an open-source MCP server for developer tools. Paste a GitHub link and your AI app sets the project up to run on your computer. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** Windows, macOS, Linux, CLI
- **Website:** https://usegeekthing.com
- **Repository:** https://github.com/usegeekthing/ugt
- **MCP Registry name:** com.usegeekthing/ugt
- **Categories:** developer tools
- **Listing updated:** 2026-11-14

## About

The idea is to close the gap between finding a repository and having it work. You hand UGT a GitHub link, optionally with an error you hit or a goal, and it looks for a ready-made setup, called a recipe, or the project's own installer. When neither exists, your AI app continues with the same link and can write a recipe itself.

The result is something you open: a file job checks its output, and an app opens at its own address and keeps saved data between runs. Once a setup works, it can be submitted to a shared catalogue so the next person gets it faster. The hosted MCP endpoint shows what a recipe runs and reaches before anything is installed, and gives the line that installs UGT.

The README says UGT is free, open source and runs on Windows, Mac and Linux, with no subscription, though your AI app's own usage limits still apply. It lists Codex, Claude Code, Cursor, VS Code and Gemini CLI as clients, and notes that web chats such as ChatGPT cannot run software on your computer.

## Features

- **Link-first setup:** Start from a GitHub URL, with an optional error message or task.
- **Recipes:** Reuses a checked setup or has your agent create one when the project has none.
- **Runs locally:** Produces files or apps on your own machine; apps keep saved data.
- **Shared catalogue:** Working recipes can be submitted for others to reuse.
- **Stdio and hosted:** Run ugt mcp locally or use the hosted Streamable HTTP endpoint.
- **Many install routes:** Desktop extension, curl or PowerShell script, Homebrew or Scoop.

## Good for

- Get a GitHub tool running without reading its install guide
- Retry a failed install by passing the error you saw
- Reuse a recipe someone else already verified
- Preview what a setup will run and reach before running it
- Share a working setup for a project that lacked an installer

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http ugt https://mcp.usegeekthing.com/mcp
```

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

```sh
https://mcp.usegeekthing.com/mcp
```

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

```json
{
  "mcpServers": {
    "ugt": {
      "url": "https://mcp.usegeekthing.com/mcp"
    }
  }
}
```

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

```json
{
  "servers": {
    "ugt": {
      "type": "http",
      "url": "https://mcp.usegeekthing.com/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "ugt": {
      "serverUrl": "https://mcp.usegeekthing.com/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "ugt": {
      "type": "http",
      "url": "https://mcp.usegeekthing.com/mcp"
    }
  }
}
```

## Tools

- `search_recipes`: Find how UGT gets a job done on the user's own computer with open-source software from GitHub, such as subtitles, CAD, video or web pages to Markdown. Search by what the user wants done or by a project's name, or omit the query to list the newest recipes. A recipe is a verified way to get one project doing one job, shared so the next person gets it fast.
- `get_project`: Get how UGT runs one GitHub project, by owner/repo or its link: the recipes people have shared for it, each verified for one job. Every GitHub project works with UGT, so the result always says what to do next.
- `get_recipe`: Get one recipe in full: what it takes and makes, what stays usable after a run, the settings it asks for, everything it can reach and why, where it was tested, and every file it runs.
- `read_recipe_file`: Read one of a recipe's files, such as compose.yaml, its Dockerfile or recipe.json, to see exactly what it runs.
- `get_install`: Get the one line that installs UGT on the user's Windows PC, Mac or Linux computer and connects it to their AI apps, UGT for Claude Desktop, and what each computer runs recipes in. Omit the computer to get every one.

## FAQ

### Does UGT cost anything?

The README calls it free and open source, with no subscription; your AI app's own pricing and limits still apply.

### Which AI apps work with it?

The site lists Codex, Claude Code, Cursor, VS Code and Gemini CLI, plus Claude Desktop through an extension.

### Can I use it from a web chat?

Not for running software: the site says web chats like ChatGPT cannot run software on your computer.

### What platforms does it support?

Windows, Mac and Linux.

### Is UGT: Use the Geek Thing free?

Yes. UGT: Use the Geek Thing is open source, so you can use and self-host it for free.

### How do I add UGT: Use the Geek Thing to Claude Code?

Run this command in your terminal: claude mcp add --transport http ugt https://mcp.usegeekthing.com/mcp

### What are the best alternatives to UGT: Use the Geek Thing?

The closest alternatives to UGT: Use the Geek Thing are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/ugt-use-the-geek-thing
