
302AI Basic MCP Server
β 1from 302ai
A toolkit for enhancing the fundamental capabilities of large language models.
β labsco summary β our analysis, not the vendor's
What it is β a toolkit MCP server from 302.AI that enhances an LLM's fundamental capabilities with search, computation and content tools.
What you get β
- Web, Wiki and Arxiv search
- Calculator and code execution
- File parser and webpage upload
- Dynamic tool loading that auto-updates the tool list from the remote server
Requirements β a 302AI API key (302AI_API_KEY), obtained from the 302.AI dashboard; the declared env list is empty but the config requires the key.
Cost snapshot β the server is free and MIT-licensed, but its tools call the 302.AI platform β you need a 302AI API key and usage is billed by 302.AI.
Setup effort β npx one-liner (npx -y @302ai/basic-mcp) with your key, or build from source; works with Claude Desktop, Cherry Studio and ChatWise.
Our take β A convenient all-in-one capability pack for chat clients. Caveat: despite the MIT server, the actual tools depend on the paid 302.AI service and API key, so it's not truly free to run at scale.
Source: the project README β summarized 2026-07-08.
β readme from github β mirrored (latest on GitHub β)
π€ 302AI Basic MCP Serverπβ¨
302AI Basic Tools is a toolkit for enhancing the fundamental capabilities of large language models.

Previews
Here are some usage examples


Here is the list of supported tools

β¨ Features β¨
- π§ Dynamic Loading - Automatically update tool list from remote server.
- π Multi modes supported, you can use
stdinmode locally, or host it as a remote HTTP server
π Tool List
- Wiki Search
- Arxiv Search
- Calculator
- Code Execution
- Web Search
- File Parser
- Upload webpage
Development
Install dependencies:
npm installBuild the server:
npm run buildFor development with auto-rebuild:
npm run watchβ¨ About 302.AI β¨
302.AI is an enterprise-oriented AI application platform that offers pay-as-you-go services, ready-to-use solutions, and an open-source ecosystem.β¨
- π§ Integrates the latest and most comprehensive AI capabilities and brands, including but not limited to language models, image models, voice models, and video models.
- π Develops deep applications based on foundation models - we develop real AI products, not just simple chatbots
- π° Zero monthly fee, all features are pay-per-use, fully open, achieving truly low barriers with high potential.
- π Powerful management backend for teams and SMEs - one person manages, many people use.
- π All AI capabilities provide API access, all tools are open source and customizable (in progress).
- π‘ Strong development team, launching 2-3 new applications weekly, products updated daily. Developers interested in joining are welcome to contact us.
{
"mcpServers": {
"302ai-basic-mcp": {
"command": "npx",
"args": ["-y", "@302ai/basic-mcp"],
"env": {
"302AI_API_KEY": "YOUR_API_KEY_HERE"
}
}
}
}Installation
To use with Claude Desktop, add the server config:
On MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
On Windows: %APPDATA%/Claude/claude_desktop_config.json
{
"mcpServers": {
"302ai-basic-mcp": {
"command": "npx",
"args": ["-y", "@302ai/basic-mcp"],
"env": {
"302AI_API_KEY": "YOUR_API_KEY_HERE"
}
}
}
}To use with Cherry Studio, add the server config:
{
"mcpServers": {
"Li2ZXXJkvhAALyKOFeO4N": {
"name": "302ai-basic-mcp",
"description": "",
"isActive": true,
"registryUrl": "",
"command": "npx",
"args": [
"-y",
"@302ai/basic-mcp"
],
"env": {
"302AI_API_KEY": "YOUR_API_KEY_HERE"
}
}
}
}To use with ChatWise, copy the following content to clipboard
{
"mcpServers": {
"302ai-sandbox-mcp": {
"command": "npx",
"args": ["-y", "@302ai/basic-mcp"],
"env": {
"302AI_API_KEY": "YOUR_API_KEY_HERE"
}
}
}
}Go to Settings -> Tools -> Add button -> Select Import from Clipboard

Find Your 302AI_API_KEY here
Debugging
Since MCP servers communicate over stdio, debugging can be challenging. We recommend using the MCP Inspector, which is available as a package script:
npm run inspectorThe Inspector will provide a URL to access debugging tools in your browser.
No common issues documented yet. If you hit a problem, the repository's GitHub Issues page is the best place to look.
Licensed under MITβ you can use, modify, and redistribute it under that license's terms.
View the full license file on GitHub β