{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_mpp6zknm4ft2","handle":"iflow-search-mcp","url":"https://wellknown.network/agents/iflow-search-mcp","links":{"self":"https://wellknown.network/agents/iflow-search-mcp/record.json","html":"https://wellknown.network/agents/iflow-search-mcp","markdown":"https://wellknown.network/agents/iflow-search-mcp/record.md","api":"https://wellknown.network/api/v1/agents/iflow-search-mcp","status":"https://wellknown.network/api/v1/agents/iflow-search-mcp/status","claim":"https://wellknown.network/agents/iflow-search-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/iflow-search-mcp/claim.json","badge":"https://wellknown.network/agents/iflow-search-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/iflow-search-mcp/history","tools":"https://wellknown.network/api/v1/agents/iflow-search-mcp/tools"},"ard":{"identifier":"urn:air::server:iflow-search-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"iflow-search-mcp","summary":"MCP (Model Context Protocol) stdio server for iFlow Search (心流搜索) — exposes web_search, image_search, and web_fetch as MCP tools.","description":"# iflow-search-mcp\n\n[![PyPI - Version](https://img.shields.io/pypi/v/iflow-search-mcp?include_prereleases)](https://pypi.org/project/iflow-search-mcp/)\n[![Python Versions](https://img.shields.io/pypi/pyversions/iflow-search-mcp)](https://pypi.org/project/iflow-search-mcp/)\n\n**MCP stdio server for [iFlow Search](https://platform.iflow.cn/) (心流搜索).**\n\nExposes three MCP tools backed by the `iflow-search` core SDK:\n\n- `iflow_web_search` — web search\n- `iflow_image_search` — image search\n- `iflow_web_fetch` — fetch the readable contents of a URL\n\nThis package is a thin adapter. All HTTP, authentication, attribution-header\nconstruction, response normalization, and error mapping live in the\n[`iflow-search`](https://pypi.org/project/iflow-search/) core SDK. This package\nowns only the MCP server wiring — tool definitions, tool dispatch, and the\nstdio entry point.\n\n## Install\n\n```bash\npip install iflow-search-mcp\n```\n\n> Installing pulls in the MCP Python SDK, which transitively depends on\n> `starlette`, `uvicorn`, `sse-starlette`, `python-multipart`,\n> `pyjwt[crypto]`, and `jsonschema` — even though this server only uses\n> stdio. There is no `[stdio]` extra on the upstream package.\n\n## Configure your MCP host\n\nThe server reads its configuration from environment variables only — no\n`.env` files, no CLI flags, no config files.\n\n| Variable | Required | Notes |\n|---|---|---|\n| `IFLOW_API_KEY` | yes | iFlow API key |\n| `IFLOW_BASE_URL` | no | Override the platform base URL |\n| `IFLOW_TIMEOUT_MS` | no | Request timeout in milliseconds (positive integer) |\n| `IFLOW_MCP_CLIENT` | no | Identifier for the MCP host (e.g. `claude-desktop`); regex `^[a-z0-9._-]{1,64}$` |\n| `IFLOW_MCP_CLIENT_VERSION` | no | Version of the MCP host; only valid when `IFLOW_MCP_CLIENT` is set |\n\n### Example: Claude Desktop / Claude Code\n\n```jsonc\n{\n  \"mcpServers\": {\n    \"iflow-search\": {\n      \"command\": \"iflow-search-mcp\",\n      \"env\": {\n        \"IFLOW_API_KEY\": \"sk-...\"\n      }\n    }\n  }\n}\n```\n\nClaude Code…","publisher":{"name":"iFlow Search SDK contributors","url":null},"homepage":"https://platform.iflow.cn/docs/","repository":"https://github.com/zhengyanglsun/iflow-search-py/issues","version":"0.1.0","license":"MIT License\n        \n        Copyright (c) 2026 iFlow Search SD…","protocols":["mcp"],"tags":["ai","iflow","llm","mcp","model-context-protocol","search"],"pricing":null,"endpoints":[{"url":"pypi:iflow-search-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"dev.package-management","name":"Packages & Dependencies","confidence":0.768,"provenance":"derived"}],"categories":["dev"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"iflow-search-mcp","registry":"pypi","observedAt":"2026-11-09T11:26:09.669Z","publishedAt":"2026-05-26T06:46:22.906183Z","latestVersion":"0.1.0"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"iflow-search-mcp","url":"https://pypi.org/project/iflow-search-mcp/","firstSeenAt":"2026-09-09T21:25:27.760Z","fetchedAt":"2026-11-09T11:24:45.926Z","normalizedAt":"2026-11-09T11:24:45.926Z"}]},"firstSeenAt":"2026-09-09T21:25:27.760Z","updatedAt":"2026-11-09T11:26:09.669Z"}