Back to Browse

Basis Oss MCP Server

Developer ToolsModerate5.4MCP RegistryLocalRemote
Free

Server data from the Official MCP Registry

The Excel engine for AI agents: read, check and edit Excel models over MCP.

About

The Excel engine for AI agents: read, check and edit Excel models over MCP.

Remote endpoints: streamable-http: https://api.basis1.tech/mcp

Security Report

5.4
Moderate5.4Moderate Risk

This is a thin client for the hosted Basis API that uses an API key from BASIS_API_KEY, enforces HTTPS for non-loopback base URLs, and only sends workbook data to api.basis1.tech as documented. Its permissions (network_http for the API, file_read for user-specified local paths, env_vars for the key) match its stated purpose, and the findings are limited to low-severity notes such as reading arbitrary local paths and the documented upload of workbook contents to a third party. The code shown is truncated, so the full sdk/src/types.ts and remaining modules were not reviewed. Supply chain analysis found 8 known vulnerabilities in dependencies (0 critical, 5 high severity). Package verification found 1 issue.

13 files analyzed · 13 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

HTTP Network Access

Connects to external APIs or services over the internet.

File System Read

Reads files on your machine. Normal for tools that analyze or process local data.

env_vars

Check that this permission is expected for this type of plugin.

process_spawn

Check that this permission is expected for this type of plugin.

What You'll Need

Set these up before or after installing:

Your Basis API key, from https://api.basis1.techRequired

Environment variable: BASIS_API_KEY

Basis API base URL, to use a self-hosted serverOptional

Environment variable: BASIS_BASE_URL

How to Install & Connect

Available as Local & Remote

This plugin can run on your machine or connect to a hosted endpoint. during install.

Documentation

View on GitHub

From the project's GitHub README.

Basis clients

Open-source clients for Basis, which parses Excel workbooks, evaluates formulas, traces dependencies and edits workbook models.

PackageWhat it isDocs
@basis1/parseTypeScript SDK for the Basis parsing APIsdk/
@basis1/mcpMCP server that gives AI assistants Basis's workbook toolsmcp/

Both talk to the hosted Basis API (https://api.basis1.tech) and need an API key. The Basis engine and hosted service are separate and not part of this repository.

Quick start

npm install @basis1/parse
BASIS_API_KEY=… npx -y @basis1/mcp

Or run the MCP server from this repository with Docker:

docker build -t basis1-mcp .
docker run -i --rm -e BASIS_API_KEY=… basis1-mcp

Each package's README covers usage, configuration and what's sent over the network.

Development

Node 20.19 or later. The MCP server depends on the SDK through file:../sdk, so build the SDK first:

(cd sdk && npm ci && npm run build && npm test)
(cd mcp && npm ci && npm run build && npm test)

See CONTRIBUTING.md before opening a pull request, and SECURITY.md to report a vulnerability privately.

License

Apache License 2.0. See LICENSE.

Reviews

No reviews yet

Be the first to review this server!