Public npm package. No global install required.
VOXELL FORGE // MCP + OPENAI-COMPATIBLE
One embedding API. Every agent.
Give your coding agent production embeddings without building another integration. Forge MCP
exposes embed and list_models through one stdio package. For workflow
tools, swap one OpenAI base URL and keep the rest of your stack.
TURBO FREE · NO CARD · EMBEDDINGS ONLY · NO REQUEST DATA STORED
> npx -y @voxell/forge-mcp
registry
name ai.voxell/forge
transport stdio
secret FORGE_API_KEY
tools
✓ embed
✓ list_models
01 // MCP QUICKSTART
Paste once. Give your agent embeddings.
Create a free Forge key, replace the placeholder, and paste the configuration into your MCP client. The package runs locally over stdio and sends embedding requests to Forge.
The only required secret. Get one from the dashboard.
Generate vectors or inspect available Forge models.
{
"mcpServers": {
"forge": {
"command": "npx",
"args": ["-y", "@voxell/forge-mcp"],
"env": {
"FORGE_API_KEY": "your-forge-api-key"
}
}
}
}
{
"servers": {
"forge": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@voxell/forge-mcp"],
"env": {
"FORGE_API_KEY": "your-forge-api-key"
}
}
}
}
claude mcp add forge --env FORGE_API_KEY=your-forge-api-key -- npx -y @voxell/forge-mcp
codex mcp add forge --env FORGE_API_KEY=your-forge-api-key -- npx -y @voxell/forge-mcp
gemini mcp add forge npx -y @voxell/forge-mcp --env FORGE_API_KEY=your-forge-api-key
02 // AGENT PLATFORMS
Use the client you already ship with.
Forge uses standard stdio MCP. Pick your platform, copy the matching block, and restart its MCP connection.
Claude Code
Run the one-line install, then verify Forge with /mcp.
Codex
Add Forge to the shared Codex MCP configuration, then run codex mcp list.
Cursor
Paste the standard block into project .cursor/mcp.json or your user configuration.
Windsurf
Paste the standard block into ~/.codeium/windsurf/mcp_config.json.
Gemini CLI
Use the one-line install or add the standard block to settings.json.
VS Code
Paste the VS Code block into .vscode/mcp.json or your user profile.
Claude Desktop
Paste the standard block into the Claude Desktop MCP configuration and restart.
Any stdio MCP client
Command npx, args -y @voxell/forge-mcp, env FORGE_API_KEY.
03 // WORKFLOW RECIPES
Set once, in any OpenAI-compatible tool.
These tools already accept an OpenAI-compatible embedding endpoint. Keep their native node or provider, set the Forge base URL, add your API key, and use the familiar model aliases.
https://api.voxell.ai/v1
Works with OpenAI-compatible embedding clients.
your-forge-api-key
text-embedding-3-small
text-embedding-3-large is also supported.
1. Choose the OpenAI embedding node → 2. Paste the Forge base URL → 3. Add your key
Base URL
Base Path
API Base URL
Settings → Model Provider → add
Endpoint URL
Admin Panel → Documents
API Base URL
Endpoint
Base URL
04 // QUALITY TIERS
Dial quality, dimensions, and cost.
The same API spans three Forge tiers. Matryoshka dimensions let you shorten vectors and re-normalize them when storage matters.
Fast and economical for high-volume embedding work.
More capacity for harder retrieval and semantic matching.
Highest-quality Forge tier for demanding embedding workloads.
Voxell's Ingot-8B-R3 research model ranks #1 for English on the public MTEB leaderboard, with a 75.98 mean across 41 tasks. This model receipt is separate from the callable Forge tiers.
CONNECT FORGE
Your agent already speaks the protocol.
Get a key, paste one block, and put production embeddings inside the builder path you use today.
npm: @voxell/forge-mcp
·
GitHub: VoxellInc/forge-mcp
·
ai.voxell/forge