# forge

Connects an agent to Forge tools for turning text into vectors and checking available models. Use it to prepare embeddings for documents or search queries.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 1
- Author: VoxellInc
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/VoxellInc/forge-mcp
- Updated: 2026-10-05
- HTML: https://affpapa.org/en/nevibecode/mcp/forge

## What it does

The server exposes Forge’s embedding API through MCP. Its `embed` tool returns vectors for one text or a batch, while `list_models` reports available models and their dimensions. Set `input_type` to `query` for search queries or `document` for material you plan to index.

You need Node.js 18 or later and a Forge API key in `FORGE_API_KEY`. Choose `turbo`, `pro`, or `ultra`; `dim` lets you request smaller vectors. The server does not retain submitted text or returned vectors, though it records token counts for billing. It does not provide search or document storage, so a RAG setup needs separate components.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `FORGE_API_KEY` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add forge -e FORGE_API_KEY=<FORGE_API_KEY> -- npx -y @voxell/forge-mcp
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add forge --env FORGE_API_KEY=<FORGE_API_KEY> -- npx -y @voxell/forge-mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "forge": {
            "command": "npx",
            "args": [
                "-y",
                "@voxell/forge-mcp"
            ],
            "env": {
                "FORGE_API_KEY": "<FORGE_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "forge": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@voxell/forge-mcp"
            ],
            "env": {
                "FORGE_API_KEY": "<FORGE_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e FORGE_API_KEY=<FORGE_API_KEY> forge npx -y @voxell/forge-mcp
```
Replace <…> with your own values

## When to use it
- generate vectors for documents and search queries
- check available models and their dimensions
- compare two texts using their embeddings
- reduce vector dimensions with `dim`

## Example prompts
- Create Forge embeddings for the contents of `docs/guide.md`.
- Generate a Forge embedding for this search query.
- Show me the Forge models and their dimensions.

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 392262
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33989
- [World Monitor](https://affpapa.org/en/nevibecode/mcp/world-monitor.md) — MCP server · ★ 89609
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81163
- [Front-End Checklist](https://affpapa.org/en/nevibecode/mcp/front-end-checklist.md) — MCP server · ★ 74569
- [Scrapling MCP Server](https://affpapa.org/en/nevibecode/mcp/scrapling-mcp-server.md) — MCP server · ★ 89899

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md