mcp-malt
mcp-malt
用于 Malt API 的 MCP 服务器。它覆盖 Malt 发布的全部 13 个操作:你开具的发票、Malt 向你收取的佣金、你收到的付款,以及组织账户的 SCIM 用户预置。
它覆盖什么和不覆盖什么
Malt 的 API 比大多数人预期的要小。它只覆盖后台计费和企业用户预置,仅此而已:
Toolset | Tools | 它覆盖的范围 |
| 3 | 你向客户开具的发票,包括 PDF |
| 1 | 你收到的付款,以及每笔付款所结算的发票 |
| 3 | Malt 向你开具的佣金发票,包括 PDF |
| 2 读,4 写 | 组织账户的 SCIM 2.0 用户预置 |
没有人才搜索、没有个人资料、没有任务、没有报价、没有消息。这些是 Malt 的招牌功能,但它们都不在公共 API 中。如果你是为这些功能而来,这个服务器无法提供,任何基于已文档化 API 构建的其他东西也无法提供。
有两个针对 Malt 的社区 MCP 服务器确实能接触到这些数据,它们通过浏览器自动化驱动 Web 应用并抓取 DOM。它们自己的文档也警告说,自动化编辑个人资料可能违反 Malt 的服务条款。这个服务器只调用已文档化的 API。
Related MCP server: fintaro-mcp
获取令牌
如果你还没有账号,请在注册页面上创建一个。
使用你需要的权限范围创建一个访问令牌,并将其与你计划启用的工具集对应起来。
立即复制令牌。它只在创建时显示一次,之后不会再显示。
自由职业者账户的令牌可以自助获取。scim 工具集所需的客户团队和组织令牌,则需要通过你的 Malt 代表取得。
这里没有 OAuth 2.0。Malt 没有发布授权服务器和令牌端点,因此上面的 API 令牌是唯一的接入方式。docs/authentication.md 更详细地解释了这一点,包括那个让大多数人踩坑的请求头细节。
安装
同一次发布提供三种安装方式:npm 包(发布在 npmjs 和 GitHub Packages 上)以及 GHCR 上的容器镜像。npx 是 MCP 客户端的常见选择;Docker 适合处于较为封闭或共享的环境。
如果要从 GitHub Packages 而不是 npmjs 安装,请将 scope 指向它:在 .npmrc 中配置 @ialejander:registry=https://npm.pkg.github.com。
npx
// Claude Desktop: claude_desktop_config.json
// Cursor: .cursor/mcp.json
{
"mcpServers": {
"malt": {
"command": "npx",
"args": ["-y", "@ialejandro/mcp-malt"],
"env": {
"MALT_API_TOKEN": "your-token-here",
"MALT_TOOLSETS": "invoices,payments,fee-invoices"
}
}
}
}Claude Code
claude mcp add malt \
--env MALT_API_TOKEN=your-token-here \
--env MALT_TOOLSETS=invoices,payments,fee-invoices \
-- npx -y @ialejandro/mcp-maltDocker
服务器通过 stdin 和 stdout 使用 JSON-RPC 通信,因此必须添加 -i,并且不能加 -t。
docker run -i --rm \
-e MALT_API_TOKEN=your-token-here \
-e MALT_TOOLSETS=invoices \
ghcr.io/ialejandro/mcp-malt// Claude Desktop: claude_desktop_config.json
// Cursor: .cursor/mcp.json
{
"mcpServers": {
"malt": {
"command": "docker",
"args": [
"run", "-i", "--rm",
"-e", "MALT_API_TOKEN",
"-e", "MALT_TOOLSETS",
"ghcr.io/ialejandro/mcp-malt"
],
"env": {
"MALT_API_TOKEN": "your-token-here",
"MALT_TOOLSETS": "invoices,payments,fee-invoices"
}
}
}
}从源码安装
git clone https://github.com/ialejandro/mcp-malt
cd mcp-malt
npm ci && npm run build{
"mcpServers": {
"malt": {
"command": "node",
"args": ["/absolute/path/to/mcp-malt/dist/index.js"],
"env": {
"MALT_API_TOKEN": "your-token-here",
"MALT_TOOLSETS": "invoices,payments,fee-invoices"
}
}
}
}{
"mcpServers": {
"malt": {
"command": "docker",
"args": [
"run", "-i", "--rm",
"-e", "MALT_API_TOKEN",
"-e", "MALT_TOOLSETS",
"ghcr.io/ialejandro/mcp-malt"
],
"env": {
"MALT_API_TOKEN": "your-token-here",
"MALT_TOOLSETS": "invoices,payments,fee-invoices"
}
}
}
}配置
变量 | 默认值 | 作用 |
| 必填 | 你的令牌,来自“我的账户,API Keys” |
| 空 | 以逗号分隔的 |
|
| 暴露四个 SCIM 写入工具。仅启用 |
|
| 限制列表结果数量,因为 Malt 的计费端点不支持分页 |
|
| 出站请求速率。这是我们的设定值,不是 Malt 的,Malt 没有公布任何速率限制 |
|
| 每个请求的超时时间 |
|
| 覆盖默认地址,主要用于测试 |
|
|
|
|
|
|
如果不设置 MALT_TOOLSETS,服务器会启动但不提供任何工具。这是有意为之,而通知:你决定模型能看到哪些工具。一次只添加一个工具集。
工具集名称未知会让服务器停止并发出错误,而不是悄悄忽略它,因为拼写错误会默默让你丢掉工具,排查起来非常痛苦。
常用任务
按季度对账。 启用 invoices,payments,fee-invoices 并运行 malt_reconcile_revenue 提示词。它会拉取列表全部三份列表,将匹配 payments 与结算的发票,并报告已开票总额、税费、Malt 佣金和已收到的现金。
对账一下我 2026 年第一季度的 Malt 收入。
获取发票 PDF。 Malt 返回的 PDF 用 base64 编码后放在 JSON 响应体中。工具会对它们进行解码,并提供如实的 PDF 附件。
下载发票 INV-123456 的 PDF。
停用某人。 启用 scim 并设置 MALT_ALLOW_WRITES=true,使用 malt_user_lifecycle。它会停用而不是删除,这才是 Malt 实际支持的路径。
从我们的 Malt 组织中移除 jane.doe@acme.com。
文档
开发
npm ci
npm run typecheck
npm test
npm run build
npm run check-spec # diff the live Malt spec against spec/malt-openapi.json测试会模拟 fetch,绝不调用实时 API。
spec/malt-openapi.json 是 Malt 已发布文档的一个提交文件快照。一个每日工作流会对实时规范到与该快照的 diff,并在规范发生变化时打开 PR。Malt 一直将 info.version 保持在 0.0.1,因此该检查比较的是操作,而不是轻信版本号。
贡献力量
见 CONTRIBUTING.md。添加端点或工具集的说明见 docs/extending.md。
许可证
MIT
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Servers
- AlicenseNot gradedqualityNot gradedmaintenanceEnables programmatic access to Meta Ads data and management features, including campaign insights, ad account details, performance metrics, and change history through the Meta Ads API.

fintaro-mcpofficial
AlicenseAqualityCmaintenanceEnables MCP-capable agents to read Fintaro invoices and transactions, and upload receipts, via a scoped API key with PII-safe projections.6Apache 2.0- FlicenseNot gradedqualityCmaintenanceProvides full access to the Make.com API, enabling creation, modification, deletion, and execution of scenarios, as well as management of connections, webhooks, data stores, and organizations.
- AlicenseAqualityCmaintenanceEnables management of endpoint inventory, patching, and vulnerabilities through the Action1 REST API, with read-only access by default and optional write support for update approvals.15Apache 2.0
Related MCP Connectors
Issue, rotate and revoke scoped API-key passes for 25+ providers — the agent never sees a real key
Agent payments, API key vaulting, and governed mandates. Agents spend within user-defined limits.
Apideck Unified API MCP — 330 tools across 200+ SaaS connectors (accounting, CRM, HRIS, ATS).
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/ialejandro/mcp-malt'
If you have feedback or need assistance with the MCP directory API, please join our Discord server