ใช้ทำอะไรได้
ยังไม่มีคำอธิบายภาษาไทย ดูข้อเท็จจริงด้านล่าง หรือเปิดคำอธิบายต้นฉบับจากผู้ทำ
- ต่อแบบ คลาวด์หรือติดตั้งในเครื่อง
- บัญชีหรือคีย์ คลาวด์: ล็อกอินกับบริการตอนต่อ (OAuth) · ในเครื่อง: ไม่ต้องใส่คีย์
- หมวด เอกสาร ตาราง และงานออฟฟิศ
คำอธิบายต้นฉบับจากผู้ทำ (อังกฤษ)
Manage the AI agents your company employs: workforce review, contracts, bill checks. 42 MCP tools.ใช้คู่กับ
Skill ที่สอน AI ทำงานแบบนี้ ใช้ร่วมกับตัวนี้ได้
watermarks-remover
watermarks-remover เป็นแอปที่เน้นความเป็นส่วนตัว ใช้สำหรับลบลายน้ำ AI ออกจากเนื้อหาที่ผู้ใช้เป็นเจ้าของ
obsidian-skills
obsidian-skills คือชุดทักษะสำหรับ AI เพื่อให้ใช้งาน Obsidian CLI และรูปแบบไฟล์ของ Obsidian ได้ เช่น Markdown, Bases และ JSON Canvas
ทำไมอยู่อันดับนี้
ตัวนี้อยู่ในแท็บ "แอปที่ต่อกับ AI" ซึ่งเรียงโดยไม่ใช้ดาว ตามลำดับเหล่านี้
| 1. อยู่ในสมุด connector ของ Claude | ไม่ | |
|---|---|---|
| 2. ทีมลองใช้จริงแล้ว | ไม่ | |
| 3. ใช้กับงานคนไทย | ไม่ | |
| 4. การใช้งานไม่นับดาว | 33/100 | ความนิยม 13 · ความสด 12 · ระบบยังตอบ 8 · ถูกใจจากผู้ใช้ +0 |
| 5. ลงทะเบียนเมื่อ | 2026-11-15 |
ถูกใจจากผู้ใช้: 0 · บวกในลำดับได้สูงสุด 5 คะแนน (1 คะแนนต่อ 1 คน) ไม่มีใครจ่ายเงินเพื่อเพิ่มได้
คุณภาพ: ผลตรวจเบื้องต้นผ่าน 5/5 ข้อ (แสดงให้ดู ไม่ได้ใช้เรียง)
ติดตั้ง
เลือกโปรแกรม AI ที่คุณใช้ แล้วคัดลอกค่าตั้งไปวาง
ให้ AI ติดตั้งให้ด้วยประโยคเดียว
ติดตั้ง Metrxbot ให้หน่อย ทำตาม https://mcp.popnx.com/i/metrxbot-mcp-server.md แสดงคำสั่งให้ฉันดูและรอฉันตกลงก่อนรันคัดลอกไปวางในแชตของ AI ที่ทำงานในเครื่องคุณได้ (เช่น Claude Code, Cursor) · AI จะอ่านขั้นตอนจากเรา แสดงคำสั่งให้ดู และรอคุณตกลงก่อน · ไม่ต้องใช้คีย์ ไม่ต้องสมัคร · ดูข้อความเต็มที่ AI จะอ่าน
ผลตรวจผ่าน 5/5 · สิ่งที่คุณถามผ่านเซิร์ฟเวอร์ของผู้ทำ (metrxbot.com) · ✓ ตรวจคำสั่งแล้ว 15 พ.ย. 2569
ขั้นแรก: คุณใช้ AI ตัวไหน
เลือกแอปที่คุณใช้ ขั้นตอนจะขึ้นด้านล่าง
ต่อกับ Claude ได้ · ประมาณ 2 นาที
ไม่ต้องใช้คีย์ ไม่ต้องลงโปรแกรม · ตั้งครั้งเดียวที่ claude.ai หรือแอปบนคอม แล้วใช้ในแชตได้ · บัญชีฟรีเพิ่มได้ 1 ตัว · แผน Team/Enterprise ให้เจ้าของ (Owner) เป็นคนเพิ่ม
เปิดหน้า Connectors ของ Claude
CustomizeConnectors
กด “Add” → “Custom” → “Web” แล้วกรอก 2 ช่องนี้
คัดลอกจากที่นี่ไปวางในช่องชื่อเดียวกันบนหน้าจอของ Claude แล้วกด Continue
Name · ชื่อMetrxbotRemote MCP server URL · ที่อยู่https://metrxbot.com/api/mcp/connectกด Continue ผ่านหน้าตรวจการล็อกอินที่ Claude ตรวจเจอ · หัวข้อ Authentication เลือกตามที่ผู้ทำบอก (Sign in now, Sign in when needed หรือ No sign in) แล้วกด Add
เปิดใช้ในแชต
+ConnectorsMetrxbot
ลองเลย
ใช้ Metrxbot บอกหน่อยว่าทำอะไรให้ฉันได้บ้าง แล้วลองทำให้ดูหนึ่งอย่าง✓ ถ้า Claude บอกว่ากำลังใช้ Metrxbot หรือมีชื่อเครื่องมือของ Metrxbot ขึ้นในคำตอบ แปลว่าต่อสำเร็จ
ชื่อเมนูตรวจกับหน้าช่วยเหลือของ Anthropic เมื่อ 11 พ.ย. 2569 · หน้าจอของคุณอาจต่างเล็กน้อยตามรุ่นของแอป
ต่อกับ ChatGPT ได้ ขึ้นกับแผน
MCP แบบเต็ม: ChatGPT Business, Enterprise หรือ Edu บนเว็บ · Pro: ต่อได้ด้วยสิทธิ์อ่านและดึงข้อมูล เครื่องมือที่แก้ข้อมูลอาจใช้ไม่ได้ · Plus: เอกสารยังไม่ยืนยัน ถ้าเห็นเมนูเพิ่ม MCP แบบกำหนดเองในหน้าปลั๊กอิน ลองตามขั้นตอนได้ · ใช้บนเว็บเท่านั้น
เปิดหน้าเพิ่ม MCP ของ ChatGPT บนเว็บ
Plugins+Add custom MCP server
กรอกชื่อและที่อยู่
ใส่ชื่อ แล้ววางที่อยู่ใต้ Connection ติ๊กยอมรับคำเตือน แล้วกด Create as a plugin
Name · ชื่อMetrxbotConnection · ที่อยู่https://metrxbot.com/api/mcp/connectเลือก Metrxbot ในแชต
เปิดแชตใหม่แล้วเลือก Metrxbot จากรายการปลั๊กอินก่อนพิมพ์
ลองเลย
ใช้ Metrxbot บอกหน่อยว่าทำอะไรให้ฉันได้บ้าง แล้วลองทำให้ดูหนึ่งอย่าง✓ ถ้า ChatGPT บอกว่ากำลังใช้ Metrxbot หรือมีชื่อเครื่องมือของ Metrxbot ขึ้นในคำตอบ แปลว่าต่อสำเร็จ
ชื่อเมนูตรวจกับหน้าช่วยเหลือของ OpenAI เมื่อ 11 พ.ย. 2569 · หน้าจอของคุณอาจต่างเล็กน้อยตามรุ่นของแอป
ต่อกับ Claude Code ได้ · ประมาณ 2 นาที
ไม่ต้องใช้คีย์ ไม่ต้องลงโปรแกรม
เปิด Terminal
Mac: กด Command+Space พิมพ์ Terminal · Windows: เปิด PowerShell
วางคำสั่งนี้แล้วกด Enter
claude mcp add --transport http --scope user metrxbot https://metrxbot.com/api/mcp/connectพิมพ์ /mcp ใน Claude Code
ต้องเห็น Metrxbot ในรายการและขึ้นว่าเชื่อมต่อแล้ว
ลองเลย
ใช้ Metrxbot บอกหน่อยว่าทำอะไรให้ฉันได้บ้าง แล้วลองทำให้ดูหนึ่งอย่าง✓ ถ้า Claude Code บอกว่ากำลังใช้ Metrxbot หรือมีชื่อเครื่องมือของ Metrxbot ขึ้นในคำตอบ แปลว่าต่อสำเร็จ
ชื่อเมนูตรวจกับหน้าช่วยเหลือของ Anthropic เมื่อ 11 พ.ย. 2569 · หน้าจอของคุณอาจต่างเล็กน้อยตามรุ่นของแอป
ต่อกับ Cursor ได้ · ประมาณ 2 นาที
ไม่ต้องใช้คีย์ ไม่ต้องลงโปรแกรม
เปิดแชตของ AI ใน Cursor โหมด Agent
ลองเลย
ใช้ Metrxbot บอกหน่อยว่าทำอะไรให้ฉันได้บ้าง แล้วลองทำให้ดูหนึ่งอย่าง✓ ถ้า Cursor บอกว่ากำลังใช้ Metrxbot หรือมีชื่อเครื่องมือของ Metrxbot ขึ้นในคำตอบ แปลว่าต่อสำเร็จ
ชื่อเมนูตรวจกับหน้าช่วยเหลือของ Cursor เมื่อ 11 พ.ย. 2569 · หน้าจอของคุณอาจต่างเล็กน้อยตามรุ่นของแอป
ต่อกับ VS Code ได้ · ประมาณ 2 นาที
ไม่ต้องใช้คีย์ ไม่ต้องลงโปรแกรม
เปิดแชตของ AI ใน VS Code โหมด Agent
ลองเลย
ใช้ Metrxbot บอกหน่อยว่าทำอะไรให้ฉันได้บ้าง แล้วลองทำให้ดูหนึ่งอย่าง✓ ถ้า VS Code บอกว่ากำลังใช้ Metrxbot หรือมีชื่อเครื่องมือของ Metrxbot ขึ้นในคำตอบ แปลว่าต่อสำเร็จ
ชื่อเมนูตรวจกับหน้าช่วยเหลือของ VS Code เมื่อ 11 พ.ย. 2569 · หน้าจอของคุณอาจต่างเล็กน้อยตามรุ่นของแอป
โปรแกรมอื่นที่ใช้ MCP ได้ เช่น Windsurf, Zed หรือ Gemini CLI มีวิธีเพิ่มต่างกัน ดูวิธีของแต่ละตัวในหน้ารวมโปรแกรม
ที่อยู่สำหรับโปรแกรมที่ต่อผ่านเว็บ
https://metrxbot.com/api/mcp/connectค่าตั้งแบบไฟล์ JSON อยู่ในหัวข้อ “สำหรับคนเขียนโค้ด” ด้านล่าง
สำหรับคนเขียนโค้ด: คำสั่ง Terminal และค่าตั้ง JSON
ต่อผ่านเว็บ
Claude Code
claude mcp add --transport http --scope user metrxbot https://metrxbot.com/api/mcp/connectCursor (~/.cursor/mcp.json)
{
"mcpServers": {
"metrxbot": {
"url": "https://metrxbot.com/api/mcp/connect"
}
}
}VS Code (mcp.json)
{
"servers": {
"metrxbot": {
"type": "http",
"url": "https://metrxbot.com/api/mcp/connect"
}
}
}ติดตั้งในเครื่อง
Claude Code
claude mcp add --scope user metrxbot -- npx -y @metrxbot/mcp-serverClaude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"metrxbot": {
"command": "npx",
"args": [
"-y",
"@metrxbot/mcp-server"
]
}
}
}Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"metrxbot": {
"command": "npx",
"args": [
"-y",
"@metrxbot/mcp-server"
]
}
}
}VS Code (mcp.json)
{
"servers": {
"metrxbot": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@metrxbot/mcp-server"
]
}
}
}ค่าตั้งนี้สร้างจากข้อมูลใน registry ของผู้ทำ ถ้าไม่ตรงกับ README ให้เชื่อ README
สรุป
- ดาว GitHubi
- 2 (ดาวรวมทั้งรีโป)
รีโปนี้มี MCP หลายรายการ ดาวนับในอันดับแค่รายการเดียว - ดาวน์โหลดต่อสัปดาห์i
- 411/สัปดาห์
- โดเมนที่ยืนยัน
- ✓ metrxbot.com
- การเชื่อมต่อ
- บนเครื่องหรือคลาวด์
- ช่องทาง (transport)
- stdio, streamable-http
- รุ่นล่าสุดi
- 0.6.3-1
- ส่งเข้า registryi
- 15 พ.ย. 2569
- แก้โค้ดล่าสุดi
- 15 พ.ย. 2569
- ตรวจล่าสุดเมื่อ
- 14 พ.ย. 2569
- ผู้ทำ
- metrxbots
- แพ็กเกจ
npm: @metrxbot/mcp-server- เว็บผู้ทำ
- metrxbot.com
- สถานะใน registry
- ใช้งานอยู่
ใช้กับโปรแกรมไหนได้
ดูจากแบบการต่อของ server ตัวนี้ และเอกสารของผู้ทำโปรแกรมแต่ละตัว ตรวจเมื่อ 10 พ.ย. 2569
ต่อผ่านคลาวด์ได้ใน
ClaudeChatGPTGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast
ติดตั้งบนเครื่องได้ใน
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
คู่มือที่เกี่ยวข้อง
ทำอะไรได้บ้าง
server ให้ล็อกอินก่อนจึงจะแสดงรายการเครื่องมือ
ผลตรวจเบื้องต้นi
เราตรวจจากข้อมูลที่ใครก็เปิดดูได้ ยังไม่ได้อ่านโค้ด ข้อที่ไม่เกี่ยวกับตัวนี้ไม่นับในตัวหาร · ตรวจเมื่อ 19 พ.ย. 2569
- ✓ ผ่าน
ตัวตนผู้ทำตรงกับ repo
ชื่อใน registry ยืนยันโดเมน metrxbot.com แล้ว (registry ตรวจความเป็นเจ้าของโดเมน)
- ✓ ผ่าน
ยังมีคนดูแล
มีการแก้โค้ดล่าสุด 4 วันที่ผ่านมา
- ✓ ผ่าน
มีสัญญาอนุญาต (license)
ใช้ MIT
- ✓ ผ่าน
endpoint ตอบ
ตอบกลับใน 224 ms (HTTP 401)
- ✓ ผ่าน
ล็อกอินแบบ OAuth
ประกาศวิธีล็อกอินแบบ OAuth ให้โปรแกรม AI พาไปล็อกอินเอง
- … ยังไม่ตรวจ
คำอธิบายเครื่องมือไม่มีคำสั่งแอบแฝง
ยังไม่ได้ตรวจ เราอ่านรายการเครื่องมือตอนตรวจ endpoint
ช่องโหว่ที่เปิดเผยแล้ว (OSV.dev)
ยังไม่ได้ตรวจ
ผู้ทำ: ขอให้ตรวจใหม่ หรือแจ้งข้อมูลผิด
สำหรับผู้ทำ: ติดป้ายใน README
ถ้าคุณเป็นผู้ทำตัวนี้ คัดลอกโค้ดนี้ไปวางใน README ได้เลย ป้ายลิงก์กลับมาที่หน้านี้
[](https://mcp.popnx.com/th/servers/metrxbot-mcp-server)พูดคุย
ถาม แชร์เคล็ดลับ หรือแจ้งว่าใช้ไม่ได้ เรียงตามที่คนกดว่ามีประโยชน์
ยังไม่มีใครโพสต์ ถามหรือแชร์เป็นคนแรกได้เลย
ข้อความในส่วนนี้เขียนโดยผู้ใช้ ไม่ใช่ทีม PopNx
รีวิวจากผู้ใช้
ยังไม่มีรีวิว
เทียบกับตัวอื่นในหมวด เอกสาร ตาราง และงานออฟฟิศi
- ดาวมากกว่า 0% ของอีก 4110 ตัวในหมวดนี้
- ส่งรุ่นใหม่เข้า registry ล่าสุดกว่า 88% ของอีก 4110 ตัวในหมวดนี้
- ผลตรวจเบื้องต้นดีกว่าหรือเท่ากับ 99% ของอีก 4110 ตัวในหมวดนี้
เทียบกับทุก server ที่ยังใช้งานในหมวดนี้ทั้งทะเบียน ดาวนับเฉพาะเมื่อผู้ลงทะเบียนเป็นเจ้าของ repo
คำถามที่พบบ่อย
Metrxbot ปลอดภัยไหม?
จากการตรวจเบื้องต้นของเรา ผ่าน 5 จาก 5 ข้อที่ตรวจได้ เรายังไม่ได้อ่านโค้ด ก่อนใส่กุญแจหรือ token ให้ดูว่า server ขอสิทธิ์อะไร และเลือกกุญแจที่ทำได้เท่าที่จำเป็น
ต้องใช้กุญแจหรือรหัสอะไรบ้าง?
registry ไม่ได้ระบุว่าต้องใช้กุญแจ แต่บางตัวจะขอให้ล็อกอินตอนใช้ครั้งแรก
ตัวนี้รันบนเครื่องหรือบนคลาวด์?
ได้ทั้งสองแบบ จะลงในเครื่องหรือต่อผ่านคลาวด์ก็ได้
ยังมีคนดูแลอยู่ไหม?
repo บน GitHub มีการแก้โค้ดล่าสุด 4 วันที่ผ่านมา และส่งรุ่นล่าสุด (0.6.3-1) เข้า registry 4 วันที่ผ่านมา
ใช้กับโปรแกรมไหนได้บ้าง?
โปรแกรมที่รองรับ MCP เช่น Claude Desktop, Claude Code, Cursor และ VS Code ตัวนี้ต่อผ่าน URL จึงใช้กับโปรแกรมที่รับ remote MCP ได้ เช่น ChatGPT บนเว็บ (แบบเต็มในแผน Business ขึ้นไป · Pro แบบอ่านอย่างเดียว)
มีตัวไหนใช้แทนได้บ้าง?
ในหมวดเดียวกันมี Puter MCP, XcodeBuildMCP, Vexa, Atlassian Rovo MCP Server, Anki MCP Server
ตัวอื่นที่ทำงานคล้ายกัน
หมวดเดียวกันจากผู้ทำคนอื่น ผ่านตัวตรวจคำสั่งแล้ว ตัวทางการขึ้นก่อน แล้วเรียงตามดาว
อ่านการ์ด:↓ ดาวน์โหลดต่อสัปดาห์i★ ดาว GitHubiสามเสา: รีวิว · ผลตรวจ · การใช้งานiอัปเดต = วันที่ส่งรุ่นล่าสุดเข้า registryi
Puter MCP
Puter MCP enables AI tools to interact with Puter: manage files, websites, workers, and more
XcodeBuildMCP
ให้ AI จัดการโปรเจกต์ Xcode สั่ง build และใช้ iOS Simulator
Vexa
Meeting bot and transcripts for Google Meet, Teams and Zoom. Live or after, speakers labelled.
Atlassian Rovo MCP Server
server ทางการของ Atlassian ให้ AI ค้นและจัดการงานใน Jira และเอกสารใน Confluence ต่อผ่านคลาวด์และล็อกอินแบบ OAuth
Anki MCP Server
MCP server for Anki flashcards: adaptive review, notes, media, and deck management via AnkiConnect.
| ตัวนี้ Metrxbot | Puter MCP | XcodeBuildMCP | Vexa | Atlassian Rovo MCP Server | Anki MCP Server | |
|---|---|---|---|---|---|---|
| ทำงานที่ไหน | มีทั้งบนคลาวด์และแบบลงเครื่อง | ใช้บนคลาวด์ ไม่ต้องลงเครื่อง | ต้องลงในเครื่อง | ใช้บนคลาวด์ ไม่ต้องลงเครื่อง | ใช้บนคลาวด์ ไม่ต้องลงเครื่อง | ต้องลงในเครื่อง |
| ต้องใส่คีย์ | ไม่ | ไม่ | ไม่ | ใช่ | ไม่ | ไม่ |
| กด + ใน Claude ได้ | ไม่ | ไม่ | ไม่ | ไม่ | ใช่ | ไม่ |
| ผลตรวจเบื้องต้น | 5/5 | 4/4 | 3/3 | 2/4 | 4/4 | 3/3 |
| สัญญาอนุญาต | MIT | AGPL-3.0 | MIT | Apache-2.0 | Apache-2.0 | MIT |
| ราคา | ไม่พบค่าใช้จ่ายในทะเบียน | ไม่พบค่าใช้จ่ายในทะเบียน | ไม่พบค่าใช้จ่ายในทะเบียน | ไม่พบค่าใช้จ่ายในทะเบียน | ไม่พบค่าใช้จ่ายในทะเบียน | ไม่พบค่าใช้จ่ายในทะเบียน |
README จากผู้ทำ
เปิดอ่าน README
ส่วนนี้คัดจาก repo ของผู้ทำตามต้นฉบับ PopNx MCP ไม่ได้ตรวจหรือรับรองเนื้อหา ตัด HTML รูปภาพ และสคริปต์ออกแล้ว ลิงก์จะพาออกนอกเว็บ
Metrx MCP Server
The Model Context Protocol (MCP) server for Metrx: how a company manages the AI agents it employs. Each agent gets a job contract, a scorecard against it, and a P&L: what it cost and what it produced. This server exposes those records as tools that any MCP-compatible client (Claude, GPT, Gemini, custom agents) can call. Version 0.6.3.
This package is the single source for both transports: the npm package you run locally over stdio, and the hosted server at https://metrxbot.com/api/mcp. The public repository at https://github.com/metrxbots/mcp-server is a mirror, synced from the monorepo by packages/mcp-server/scripts/publish-mirror.ts. Contributors open pull requests against the monorepo; issues go to https://github.com/metrxbots/mcp-server/issues.
Quick Start
Three ways in.
1. The demo, no key. The public desk tools answer on the Northwind sample organization, which is synthetic demo data.
npx @metrxbot/mcp-server --demo
2. Interactive login. Opens the browser, saves the key locally, then verifies it.
npx @metrxbot/mcp-server --auth
npx @metrxbot/mcp-server --test
3. A key in the environment.
METRX_API_KEY=sk_live_xxx npx @metrxbot/mcp-server
npx @metrxbot/mcp-server --setup-claude writes the server entry into the Claude Desktop, Cursor or VS Code config for you.
Claude Code plugin
The desk plugin wraps the workforce tool set in six skills.
claude plugin marketplace add metrxbots/mcp-server && claude plugin install metrx-desk@metrxbots
Versions: this server is 0.6.3 (@metrxbot/mcp-server). The desk plugin (metrx-desk) and the TypeScript SDK (@metrxbot/sdk) are separate artefacts with their own version numbers and release schedules; each states its version in its own package.
| Command | What it does | Needs a key |
|---|---|---|
/metrx-desk:sample-review | The Northwind sample review (synthetic demo data), relayed with every figure's label | No |
/metrx-desk:draft-job-contract | Draft a job contract for one agent from a template (support_triage, sdr_qualification, internal_assistant, coding_patch); owner is required; publishing is a separate admin-scope step | No |
/metrx-desk:cost-per-resolution | The two numbers on a per-resolution AI bill: price per billed resolution and, with total conversations, the billed share. Both are the vendor's own count, labelled vendor-reported, not Verified | No |
/metrx-desk:check-vendor-bill | Reconcile a per-resolution vendor bill against your own records: matched, disputed, unmatched, uncounted, outside coverage, with the disputed amount | No |
/metrx-desk:connect-metrx | Create a key at Settings → Security, set METRX_API_KEY, restart, read your first review | Creates one |
/metrx-desk:weekly-decisions | Your decision queue; record expand, re_specify, combine or retire with a rationale | Yes (read; write to record) |
The full walkthrough, including the labels every figure carries and the plain HTTP routes, is at https://docs.metrxbot.com/desk.
Tools
The tool registry is published at https://metrxbot.com/.well-known/agent-card.json: names, descriptions, domains, the public subset that answers without a key, and the named tool sets. That file is the authoritative list; this README does not repeat it. Every tool's description ends with the scope it needs (read, write or admin).
Tool names carry the metrx_ prefix. The desk's public tools are metrx_get_workforce_review, metrx_draft_job_contract, metrx_cost_per_resolution and metrx_check_vendor_bill. Signed-in desk tools include metrx_get_decision_queue, metrx_record_decision, metrx_get_scorecard, metrx_get_job_contract and metrx_set_job_contract; cost reads such as metrx_get_cost_summary sit alongside them. A job contract is recorded, not enforced at runtime: publishing one blocks no spend or traffic.
Guided Prompts
MCP prompts are templates that walk a client through a multi-step workflow.
analyze-costs
Fetches the cost summary, lists agents, gets optimization recommendations and returns a prioritized breakdown.
Arguments:
period_days(string, optional): number of days to analyze (default: "30")
find-savings
Checks recommendations, runs the cost leak scan and explains each finding in dollars.
Arguments: none
cost-leak-scan
Runs the waste audit: retry storms, oversized contexts, model mismatch, missing caching, idle agents, missing budgets, arbitrage gaps.
Arguments:
agent_id(string, optional): scan one agent by UUID, or omit to scan all
Installation
From npm
npm install @metrxbot/mcp-server
Quick Test
Verify your API key and connection:
METRX_API_KEY=sk_live_xxx npx @metrxbot/mcp-server --test
Configuration
Environment Variables
- `METRX_API_KEY` (optional for
--demo, required otherwise): your Metrx API key. Create one at https://app.metrxbot.com/settings/security - `METRX_API_URL` (optional): override the API base URL (default:
https://app.metrxbot.com/api)
Hosted transport
The same registry is served over streamable HTTP at https://metrxbot.com/api/mcp. Add ?set=workforce to select the desk tool set. The Authorization: Bearer sk_live_... header is optional: without it the public tools answer on the demo (synthetic demo data).
{
"mcpServers": { "metrx": { "type": "http", "url": "https://metrxbot.com/api/mcp?set=workforce", "headers": { "Authorization": "Bearer sk_live_your_key_here" } } } }
MCP Client Setup (stdio)
Claude Desktop
Add to ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": { "metrx": { "command": "npx", "args": ["@metrxbot/mcp-server"], "env": { "METRX_API_KEY": "sk_live_your_key_here" } } } }
Cursor
Add to ~/.cursor/mcp.json:
{
"mcpServers": { "metrx": { "command": "npx", "args": ["@metrxbot/mcp-server"], "env": { "METRX_API_KEY": "sk_live_your_key_here" } } } }
Windsurf
Add to ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": { "metrx": { "command": "npx", "args": ["@metrxbot/mcp-server"], "env": { "METRX_API_KEY": "sk_live_your_key_here" } } } }
Or run directly:
METRX_API_KEY=sk_live_xxx npx @metrxbot/mcp-server
Rate Limiting
The stdio server enforces per-tool-category rate limits:
| Category | Limit |
|---|---|
| Dashboard & Agents | 60 requests/minute |
| Metrics | 30 requests/minute |
| Experiments | 10 requests/minute |
| Budgets | 10 requests/minute |
| Alerts | 10 requests/minute |
| Attribution | 10 requests/minute |
| Optimization | 5 requests/minute |
| Cost Leak Scan | 2 requests/5 minutes |
| Default (other) | 30 requests/minute |
The public desk routes are limited per address at 30 requests per minute; the limit rides in the X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset headers. Hitting a limit returns an error with the retry-after time in seconds.
For high-volume use, contact support@metrxbot.com.
Error Handling
Every refusal carries a class. Over MCP it is a JSON-RPC error with data.class, data.doc and data.user_message; over HTTP it is an RFC 9457 problem body with Retry-After on the retryable classes.
| Class | JSON-RPC code | HTTP status | Doc |
|---|---|---|---|
auth_required | -32001 | 401 | https://docs.metrxbot.com/desk#errors-auth-required |
insufficient_scope | -32002 | 403 | https://docs.metrxbot.com/desk#errors-insufficient-scope |
rate_limited | -32003 | 429 | https://docs.metrxbot.com/desk#errors-rate-limited |
limiter_unavailable | -32004 | 503 | https://docs.metrxbot.com/desk#errors-limiter-unavailable |
demo_unavailable | -32005 | 503 | https://docs.metrxbot.com/desk#errors-demo-unavailable |
unknown_agent_key | -32006 | 404 | https://docs.metrxbot.com/desk#errors-unknown-agent-key |
invalid_params | -32602 | 400 | https://docs.metrxbot.com/desk#errors-invalid-params |
transport_error | -32007 | 502 | https://docs.metrxbot.com/desk#errors-transport-error |
Server errors from the upstream API (500 and above) are retried with exponential backoff, up to 3 times.
Authentication
Requests to your own organization carry METRX_API_KEY in the Authorization header:
Authorization: Bearer sk_live_xxx
API keys are environment-scoped: sk_live_* for production, sk_test_* for testing, mk_* for machine keys.
Each key also carries scopes. Read tools need read; tools that change data need write; budget changes, publishing a job contract and creating an experiment need admin. An org owner or admin mints keys, including admin-scoped ones, in Settings → Security → API Keys.
Testing
Verify your API key:
METRX_API_KEY=sk_live_xxx npx @metrxbot/mcp-server --test
Run the test suite:
npm run test
Tests cover:
- Protocol compliance (MCP spec validation)
- Tool schema and input validation
- API client retry logic and error handling
- Rate limiting behavior
- Output formatting
Troubleshooting
"METRX_API_KEY environment variable is required"
Set the key before starting the server, or run --demo for the public tools:
export METRX_API_KEY=sk_live_your_key
npx @metrxbot/mcp-server
Create a key at https://app.metrxbot.com/settings/security, or run npx @metrxbot/mcp-server --auth.
"Rate limit exceeded"
The error message includes a retry-after time in seconds. Your MCP client should retry after it. For production volume, contact support.
"401 Unauthorized" or auth_required
Your API key is invalid, expired or missing. Create a new one at https://app.metrxbot.com/settings/security.
unknown_agent_key
No agent in your organization has that agent_key. Check the Agents page in the dashboard; the error's suggestions lists close matches when there are any.
Support
- Docs: https://docs.metrxbot.com (the desk: https://docs.metrxbot.com/desk)
- API Status: h