You.com Web Access & AI

io.github.youdotcom-ossPublished by GitHub account youdotcom-ossv4.0.7Updated Oct 30, 2026

Web search, AI agent, and content extraction via You.com APIs

VerifiedStreamable HTTPWeb executableWeb Search & ScrapingFinanceAI & ML

Overview

AI-generated overview

You.com's hosted MCP server for web search, content extraction, AI agent research and finance lookups, reachable remotely or through a local STDIO bridge.

What you can do
  • Search the web and discover sources with the hosted search and discover tools
  • Fetch and extract page contents from URLs
  • Run AI agent research and finance lookups when those tools are requested
  • Check account balance for the API key in use
  • Proxy all of this through a local STDIO bridge or connect directly to the remote endpoint
When to use it
Use it when an assistant needs live web search results, page content extraction, or research and finance answers from You.com, either keyless on the free profile or with an API key for the full tool set.
Requirements
Either a remote streamable HTTP endpoint or the npm package run locally with Node.js via npx. No key is needed for the free profile; authenticated use needs a You.com API key passed as YDC_API_KEY or an Authorization bearer header. Optional YDC_PROFILE and YDC_ALLOWED_TOOLS select the profile and exposed tools. Network access to the You.com API.
Before you install
The API key is a billable credential sent as a bearer token; keep it out of shared configs. Authenticated use can consume paid credits, and the balance tool exposes account usage. Queries and fetched URLs are sent to You.com's servers. The local package is only a proxy, so tool behavior is controlled by the remote service.

Installation

In SourceWeft

  1. Open You.com Web Access & AI in the dashboard and add it to a workspace.
  2. Connect the required credentials. They are stored privately and never shown on public pages.
  3. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.youdotcom-oss%2Fmcp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config. The client completes OAuth sign-in on first connect.

{
  "mcpServers": {
    "you-com-web-access-ai": {
      "type": "http",
      "url": "https://api.you.com/mcp"
    }
  }
}

README

@youdotcom-oss/mcp

Bin-only STDIO bridge for the hosted You.com MCP server at https://api.you.com/mcp.

This package does not register tools locally and does not contain REST tool logic. Its only job is to proxy STDIO MCP traffic to the hosted remote server.

Quick start

jsonc
// Add this to your MCP client config (Claude Desktop, Cursor, Windsurf, etc.)// Free tier — no API key, no signup.{  "mcpServers": {    "you": {      "command": "npx",      "args": ["@youdotcom-oss/mcp"],      "env": { "YDC_PROFILE": "free" }    }  }}

If your client supports remote MCP, point it at https://api.you.com/mcp?profile=free directly — no local process needed.

Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

jsonc
{  "mcpServers": {    "you": {      "command": "npx",      "args": ["@youdotcom-oss/mcp"],      "env": { "YDC_PROFILE": "free" }    }  }}

Authenticated (all default tools):

jsonc
{  "mcpServers": {    "you": {      "command": "npx",      "args": ["@youdotcom-oss/mcp"],      "env": { "YDC_API_KEY": "<your-key>" }    }  }}

Claude Code

bash
# Free tierclaude mcp add you -e YDC_PROFILE=free -- npx @youdotcom-oss/mcp
# Authenticatedclaude mcp add you -e YDC_API_KEY=<your-key> -- npx @youdotcom-oss/mcp

Cursor

Add to ~/.cursor/mcp.json (or .cursor/mcp.json in a project):

jsonc
{  "mcpServers": {    "you": {      "command": "npx",      "args": ["@youdotcom-oss/mcp"],      "env": { "YDC_PROFILE": "free" }    }  }}

Windsurf

Add to ~/.codeium/windsurf/mcp_config.json:

jsonc
{  "mcpServers": {    "you": {      "command": "npx",      "args": ["@youdotcom-oss/mcp"],      "env": { "YDC_PROFILE": "free" }    }  }}

VS Code

Add to your user or workspace mcp.json:

jsonc
{  "servers": {    "you": {      "command": "npx",      "args": ["@youdotcom-oss/mcp"],      "env": { "YDC_PROFILE": "free" }    }  }}

Any MCP client (remote)

If your client speaks streamable HTTP, skip the local bridge:

https://api.you.com/mcp?profile=free

Authenticated:

https://api.you.com/mcpAuthorization: Bearer <your-key>

Install

bash
bun add @youdotcom-oss/mcp

Or run it directly:

bash
npx @youdotcom-oss/mcp

Environment

  • YDC_API_KEY Optional. Sent as Authorization: Bearer <key>.
  • YDC_PROFILE Optional. When set to free, routes the bridge to https://api.you.com/mcp?profile=free.
  • YDC_ALLOWED_TOOLS Optional. Comma-separated hosted tool ids to expose through https://api.you.com/mcp?tools=....

YDC_PROFILE takes precedence over YDC_ALLOWED_TOOLS.

Tool exposure

The default hosted MCP URL exposes four tools:

  • you-search
  • you-contents
  • you-balance
  • you-discover

Two additional tools are available on request:

  • you-finance
  • you-research

Request additional tools explicitly with tools. tools scopes the visible tool set.

Today, profile=free is a keyless mode. It overrides tools and exposes you-search and you-discover.

Examples:

  • Default tool set: https://api.you.com/mcp
  • Finance only: https://api.you.com/mcp?tools=you-finance
  • Search plus finance: https://api.you.com/mcp?tools=you-search,you-finance
  • Research only: https://api.you.com/mcp?tools=you-research
  • Free profile (keyless): https://api.you.com/mcp?profile=free

Links

Contributing

Development setup and code conventions live in AGENTS.md; contribution flow and PR conventions live in CONTRIBUTING.md. Issues and PRs welcome.

License

MIT — see LICENSE.

Source: README.md at commit f8a358a

Tools

0
This server asks you to sign in, so SourceWeft could not read its tools without an account and has not indexed them. What a connected account sees can depend on that account and its permissions.

Version history

5
  1. v4.0.7LatestOct 29, 2026
  2. v4.0.6Oct 24, 2026
  3. v4.0.4Oct 14, 2026
  4. v4.0.3Oct 2, 2026
  5. v4.0.0Sep 16, 2026

Score

85% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts