ufn-server
MCP Server for the UniFuncs API
Installation
npx @unifuncs/ufn-mcp-serverAsk AI about ufn-server
Powered by Claude · Grounded in docs
I know everything about ufn-server. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Reviews
Documentation
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
- 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: U1, U1-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)
Count: Results per page, 1-50, default 10 (optional)
Format: json | markdown | text, default json (optional)
web-reader
URL: Page URL to read
Format: markdown (optional)
IncludeImages: boolean (optional)
LinkSummary: boolean (optional)
deep-search-sync
Model: s3 (default: s3)
Messages: Array of {role: "user"|"assistant"|"system", content: string}
Stream: boolean (default: false)
deep-search-create-task
Model: s3 (default: s3)
Messages: Array of {role: "user"|"assistant"|"system", content: string}
Returns: task_id for querying status
deep-search-query-task
Task_ID: Task ID from create_task
Returns: Task status, progress, and results when completed
deep-research-create-task
Model: u1 | u1-pro (default: u1)
Content: Research question/topic
Introduction: Researcher persona (optional)
Reference_Style: link | number | footnote (default: link)
Generate_Summary: boolean (default: false)
Max_Depth: 1-50 (default: 25, recommended)
Domain_Scope: Comma-separated domains (optional)
Domain_Blacklist: Comma-separated domains to exclude (optional)
Output_Prompt: Custom output template (optional)
Important_URLs: Comma-separated URLs (optional)
Important_Keywords: Comma-separated keywords (optional)
Important_Prompt: Important prompt content (optional)
Push_To_Share: boolean (default: false)
Set_Public: boolean (default: false)
Returns: task_id for querying status
deep-research-query-task
Task_ID: Task ID from create_task
Returns: Task status, progress, and results when completed
Examples
Web Search
{
"query": "OpenClaw AI",
"count": 5,
"format": "json"
}
Deep Search Async
// Create task
{
"model": "s3",
"messages": [
{ "role": "user", "content": "What are the latest developments in AI?" }
]
}
// Query task (use returned task_id)
{
"task_id": "3aff2a91-7795-4b73-8dab-0593551a27a1"
}
Deep Research
// Create research task
{
"model": "u1",
"content": "Analyze the impact of AI on healthcare",
"max_depth": 25,
"domain_scope": "arxiv.org, nature.com",
"generate_summary": true
}
// Query research task
{
"task_id": "research-task-id-here"
}
Pricing
- Web Search: Pay per request
- Web Reader: Pay per request
- Deep Search: Pay per token usage
- Deep Research:
- U1: 0.6 PTC/M Tokens
- U1-Pro: 1.2 PTC/M Tokens
For detailed pricing, visit: https://unifuncs.com/pricing
Support
- Documentation: https://unifuncs.com/api
- GitHub: https://github.com/UniFuncs/ufn-mcp-server
- Email: service@unifuncs.com
- WeChat: unifuncs
Maintainer Release Checklist
Before documenting new tools in the npx setup section, make sure the npm package has been published and smoke-tested.
- Bump the package version.
- Install dependencies and run
npm run build. - Publish the package to npm.
- Verify
npm view @unifuncs/ufn-mcp-server versionmatches the intended release. - Verify
npx -y @unifuncs/ufn-mcp-serverexposes the same tools described in this README. - Update the changelog and README after the npm release is available.
License
MIT
Changelog
v0.1.0 (2026-02-25)
- Added Deep Search sync API support
- Added Deep Search async API (create_task + query_task)
- Added Deep Research async API (create_task + query_task)
- Enhanced documentation with all tool references
- Improved error handling
v0.0.6
- Initial release with web-search and web-reader
