Mercos

io.github.mcp-dirPublished by GitHub account mcp-dirv0.1.0Updated Oct 27, 2026

Sales force and rep ERP on Mercos via the official API. List orders, customers, products, price tabl

VerifiedStreamable HTTPWeb executableFinance Business & Commerce

Server details

Identifier: io.github.mcp-dir/mercos-mcp
Transport: Streamable HTTP
Runtime: Web executable
Trust: Verified
Published: Sep 16, 2026

Security note

MCP servers receive tool arguments from a conversation and may perform external actions. Review what a server can do before you enable it, and give it only the access it needs.

The registry verified the GitHub account mcp-dir for this listing. That does not show the account is the product's maker.

SourceWeft's checks cover whether the listing is complete and the endpoint answered; they do not review the server's code or what its tools do.

Add a badge to your README

Show readers this MCP server is listed on SourceWeft. The badge links to this page.

[![Listed on SourceWeft](https://sourceweft.com/badge/mcp/io.github.mcp-dir%2Fmercos-mcp.svg)](https://sourceweft.com/mcp/io.github.mcp-dir%2Fmercos-mcp?utm_source=readme&utm_medium=badge)

Overview

AI-generated overview

Connects an assistant to Mercos ERP data through the official API, to list and create orders, customers, products, stock and pricing records.

What you can do: List accounts, customers, products, orders, price tables, categories, payment terms, carriers, users, commissions and financial titles, with incremental filters by change date
Create and update customers and products, including batched edits by id
Create and update orders, and adjust product stock in bulk
Create price tables
Check connection status, toolkit state and versions, and search the mcp.ai marketplace for other tools
Report bugs or feedback, and authenticate with an access token
When to use it: Useful when an assistant should read or maintain Mercos ERP records — sales orders, customer and product registrations, stock levels, price tables and commissions — without switching to the Mercos interface.
Requirements: Remote streamable HTTP endpoint; no packages or environment variables declared. A Mercos account connected to the install is needed, and the authenticate tool expects a browser-obtained access token, either as an Authorization Bearer header or pasted for a session-only login.

Before you install

Several tools write to the ERP: creating and updating customers, products and orders, bulk stock adjustments and new price tables can change business records, and bulk variants act on many ids at once. The authenticate tool asks for an access token that grants access to the connected Mercos account; treat it as a secret. The report_bug tool sends recent conversation messages for reproduction.

Installation

In SourceWeft

Open Mercos in the dashboard and add it to a workspace.
Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.mcp-dir%2Fmercos-mcp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "mercos": {
      "type": "http",
      "url": "https://api.mcp.ai/p_mercos"
    }
  }
}

README

This repository has no README.

Tools

mercos_list_accounts

Lista as empresas (CompanyToken) Mercos conectadas a este install, com id e label.

Parametersaccount