UniFuncs MCP Server

MCP Server for the UniFuncs API - Enhanced with Deep Search and Deep Research capabilities

Features

This MCP server provides access to the following UniFuncs APIs:

1. Web Search (web-search)

Real-time web search with comprehensive results

• Search across the internet with keywords
• Filter by freshness (Day/Week/Month/Year)
• Pagination support (1-50 results per page)
• Multiple output formats (JSON/Markdown/Text)

2. Web Reader (web-reader)

Extract detailed content from web pages

• Clean content extraction
• Optional image inclusion
• Link summary support
• Markdown output

3. Deep Search - Sync (deep-search-sync)

Real-time deep search with immediate results

• Model: S3 / S3 Pro
• Streaming support
• Instant response

4. Deep Search - Async (deep-search-create-task + deep-search-query-task)

Asynchronous deep search for complex queries

• Create task and get task_id immediately
• Poll for task status and results
• Background processing for large queries

5. Deep Research (deep-research-create-task + deep-research-query-task)

Comprehensive deep research capabilities

• Models: U3, U3 Pro
• Customizable research parameters:
  • Introduction: Set researcher persona
  • Reference style: link/number/footnote
  • Max depth: Up to 50 iterations (25 recommended)
  • Domain scope: Limit search to specific domains
  • Domain blacklist: Exclude specific domains
  • Custom output prompts
  • Important URLs, keywords, and prompts
• Async task management

Setup

API Key

Get a UniFuncs API Key: https://unifuncs.com/account

NPX (STDIO)

{
    "mcpServers": {
        "unifuncs": {
            "command": "npx",
            "args": [
                "-y",
                "@unifuncs/ufn-mcp-server"
            ],
            "env": {
                "UNIFUNCS_API_KEY": "sk-**********"
            }
        }
    }
}

Note: the npx experience reflects the latest package published to npm, not necessarily the current main branch. If the published npm version is behind main, use the source build instructions below to reproduce the latest merged toolset.

Source Build (Local)

git clone https://github.com/UniFuncs/ufn-mcp-server.git
cd ufn-mcp-server
yarn install
npm run build
UNIFUNCS_API_KEY=sk-********** node build/index.js

Example Codex MCP config:

[mcp_servers.unifuncs-local]
command = "node"
args = ["/absolute/path/to/ufn-mcp-server/build/index.js"]

[mcp_servers.unifuncs-local.env]
UNIFUNCS_API_KEY = "sk-**********"

SSE Server

For SSE transport, set the environment variable:

export UNIFUNCS_SSE_SERVER=true
export UNIFUNCS_SSE_SERVER_PORT=5656  # Optional, default is 5656

Or use the --sse flag:

npx @unifuncs/ufn-mcp-server --sse

Tool Reference

web-search

Query: Search keywords
Freshness: Day | Week | Month | Year (optional)
Page: Page number, default 1 (optional)