Skip to main content
Glama
baselinker-mcp

baselinker-mcp

baselinker-mcp

Free, open-source MCP server + CLI for the BaseLinker API. There is no free BaseLinker MCP on the market — this is one. MIT licensed.

It is token-lean by design: instead of dumping ~150 tool schemas into the model's context, it exposes two tools — a generic baselinker_call that can invoke any of the ~150 API methods (including future ones), and baselinker_list_methods for on-demand discovery. Full API coverage, minimal context cost.

Install

pipx install baselinker-mcp        # or: pip install baselinker-mcp

From source:

git clone https://github.com/konradbachowski/baselinker-mcp
cd baselinker-mcp
pip install -e .

Related MCP server: clickup-mcp

Get a token

BaseLinker panel → My account → API → copy the token. Then either:

baselinker auth set <YOUR_TOKEN>      # stored in ~/.config/baselinker/config.json (chmod 600)
# or
export BASELINKER_TOKEN=<YOUR_TOKEN>

MCP usage

The server command is baselinker-mcp and reads BASELINKER_TOKEN from the environment.

Claude Desktop / Claude Code (claude_desktop_config.json or .mcp.json):

{
  "mcpServers": {
    "baselinker": {
      "command": "baselinker-mcp",
      "env": { "BASELINKER_TOKEN": "your-token-here" }
    }
  }
}

Cursor (.cursor/mcp.json): same shape.

The two exposed tools:

Tool

Purpose

baselinker_call(method, parameters)

Invoke any BaseLinker API method.

baselinker_list_methods(filter?)

Discover method names, categories and params.

CLI usage

baselinker methods                       # list all ~150 methods
baselinker methods order                 # filter by name/category
baselinker call getOrders --params '{"get_unconfirmed_orders": true}'
baselinker call updateInventoryProductsStock \
    --params '{"inventory_id": 123, "products": {"456": {"bl_001": 10}}}'

Output is the raw JSON response from BaseLinker.

Security

  • Never commit your token. .env and ~/.config/baselinker/ are gitignored.

  • The API token grants full account access — treat it like a password.

  • BaseLinker rate limit is 100 requests/min; the client throttles to stay under it.

Method coverage

All ~150 documented methods across Orders, Invoices, Receipts, Order Returns, Courier Shipments, CRM, Product Catalog (Inventory), Inventory Documents, Purchase Orders, Fulfillment Deliveries, Suppliers, Payers, BaseLinker Connect and External Storages. Run baselinker methods for the full list, or read the API docs.

Need it built for you?

This tool is free — but wiring BaseLinker into your stack (syncing stock and orders across marketplaces, automating fulfillment, connecting your ERP/CRM, custom integrations) is real work. That's what we do at HeyNeuron, an AI-first software house.

If you want BaseLinker automation or an e-commerce integration implemented, get in touch.

License

MIT — see LICENSE.

Available Tools

2 tools
baselinker_callBaselinker CallA

Call any BaseLinker API method and return its JSON response.

method is the exact API method name (e.g. "getOrders", "addOrder", "updateInventoryProductsStock"). parameters is that method's argument object. Use baselinker_list_methods first to discover names and params.

Inputs: method (required), parameters. Returns: object

baselinker_list_methodsBaselinker List MethodsA

List available BaseLinker API methods with name, category, description and common params. Pass filter to match a substring of the method name or category (e.g. "order", "inventory", "courier").

Inputs: filter. Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.4/5.0

    Scored across 2 tools

    Disambiguation5/5

    The two tools have completely distinct purposes: one discovers available API methods and the other invokes them. There is no overlap or ambiguity in selecting between them.

    Naming Consistency4/5

    Both tools share the baselinker_ prefix and use snake_case, but baselinker_call is a bare verb while baselinker_list_methods follows a verb_noun pattern. This is a minor inconsistency rather than a chaotic naming scheme.

    Tool Count4/5

    At two tools, this is slightly below the typical 3-15 range, but each tool earns its place for a generic API bridge: one for discovery and one for execution. The count is minimal without feeling incomplete.

    Completeness5/5

    The generic baselinker_call provides access to every BaseLinker API method, so there are no missing CRUD or lifecycle operations. The baselinker_list_methods tool covers the discovery gap that would otherwise leave agents guessing at method names.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers