Blog
 / 
Partnerships
October 15, 2026

The You.com Paperclip Connector Brings Live Web Search to Every Agent in Your Org

Madison Lee
, 

Senior Partnerships Lead

TLDR: Paperclip, the open-source platform for managing the work of agents, now includes You.com in its connector catalog. Any agent in a Paperclip org, whether it runs on Claude, Codex, Gemini, Cursor, OpenClaw, or Hermes, can call You.com tools for live web and news search, full-page content extraction, and API discovery.

Teams can connect with browser sign-in, an API key, or a free profile that needs no key at all. Every tool comes with its own permission setting, and every call shows up in Paperclip's ticket trace and audit log. This post covers what agents can do with the connector, how to connect it, how it fits Paperclip's governance model, and what a research agent looks like when it cites live sources on a schedule.

Paperclip lets you run a company of AI agents using different models and harnesses together. For example, a CEO running on Hermes, a CMO on OpenClaw, and an SEO analyst that wakes up every eight hours to check rankings. Paperclip gives those agents goals, budgets, and a reporting structure. What they also need is a current view of the world. A model's training data stops at a fixed date, and an SEO analyst that can't see this week's search results, or a CMO that can't read a competitor's launch post from this morning, is working from an old map.

The You.com Paperclip connector gives every agent in the org the live web, through the same permissions and audit trail Paperclip already applies to everything else.

What the You.com Paperclip Connector Gives Your Agents

The connector links Paperclip to the hosted You.com MCP server at api.you.com/mcp. Once it's connected, agents get four tools:

  • you-search runs web and news searches. Agents can set query, count, freshness, and offset, and use inline operators such as site:, lang:, loc:, and filetype: to narrow results by domain, language, location, or file type.
  • you-contents takes a URL and returns the extracted content of the page, so an agent can read the full article instead of working from a snippet.
  • you-discover helps an agent pick the right You.com API for the task in front of it.
  • you-balance reports the remaining credit on your You.com account, which makes it easy for a cost-reporting agent to keep track of spend.

Search and extraction work as a pair. An agent searches, reviews the results, and pulls the full text of the pages it wants. That lets it quote a source accurately and link to it, rather than paraphrasing a two-line summary.

Three Ways to Connect the You.com Paperclip Connector

MethodEndpointCredentialsTools
Sign in with You.comapi.you.com/mcpOAuth 2.1 browser sign-inyou-search, you-contents, you-discover, you-balance
Use an API keyapi.you.com/mcpKey from you.com/platform, sent as Authorization: Beareryou-search, you-contents, you-discover, you-balance
Use the free profileapi.you.com/mcp?profile=freeNoneyou-search and you-discover, 100 queries per day

The free profile is the fastest way in. There is no account to create and no key to paste, so you can give an agent live search on the same afternoon you install Paperclip and watch how it uses it. When your agents are ready to read full pages, sign in or add a key and the extraction and balance tools appear alongside search.

Browser sign-in suits most teams. For headless deployments, such as Paperclip running on a VPS or Fly.io, the API key route works without a browser. A dedicated key for Paperclip also keeps its usage easy to track on its own.

Live Web Access That Follows Paperclip's Governance Model

Paperclip agents can work toward goals and projects over long horizons, picking up assigned tasks or checking in on a schedule between your own work sessions. You.com gives supported agents access to current web information as they research, while Paperclip lets you manage access and review their work.

Every You.com tool has three settings. Allowed runs immediately. Ask first holds the call until a person approves it. Off removes the tool. A marketing team might start with the SEO analyst on Allowed for both search and extraction, since tracking rankings is its whole job, and the CMO on Allowed for search with extraction on Ask first, so the team can see which pages it chooses to read. you-balance can stay with whichever agent owns cost reporting. As trust builds, you move settings from Ask first to Allowed, one tool at a time.

Budgets work the same way. The Web Search API is priced at $5 per 1,000 calls, so spend is predictable. A copywriter agent on a four-hour heartbeat that runs 10 searches each time it wakes makes about 1,800 searches a month, which comes to roughly $9. Paperclip's per-agent budgets and you-balance let you watch that number from both sides. For organizations with strict data requirements, You.com also offers Zero Data Retention at the account level.

What This Unlocks Across an Agent Org

Because Paperclip is agent-agnostic, one connection serves every runtime in the org chart. Some of the roles that benefit right away:

  • SEO analyst: checks where target pages rank this week, using site: and freshness to compare results over time.
  • CMO or competitive intel agent: reads competitor launch posts, pricing pages, and press coverage in full, then files a summary to the ticket with links.
  • Copywriter: drafts from current sources and cites them, instead of filling gaps from memory.
  • Engineering agent: uses you-discover to choose the right You.com API, then reads current library docs and release notes before it writes code.

Teams that want deeper capability can also add the You.com research and finance tools. They run on their own endpoints and slot in through Paperclip's custom MCP server support:

{
  "mcpServers": {
    "you.com_research": {
      "url": "https://api.you.com/mcp/research",
      "headers": { "Authorization": "Bearer <YDC_API_KEY>" }
    }
  }
}

That gives a research analyst agent you-research for multi-step, citation-backed research, with its own key so its usage is tracked separately from everyday search.

Example: A Research Agent That Shows Its Sources

An SEO Team That Turns Research Into Reviewed Content

Consider a marketing team working to improve its visibility in AI-generated answers. Its Paperclip SEO analyst identifies a question the company's content doesn't answer well, using recommendations from an AEO tool such as Gauge, and assigns a research task.

The researcher uses You.com to find relevant sources, including competitor articles and current product documentation. It builds a brief with source links, the questions the article should answer, and claims that need checking. A writer turns that brief into a draft, and an editor reviews it for accuracy, clarity, and usefulness.

Paperclip coordinates the handoffs and keeps the brief, draft, and feedback connected to the work. When the article is ready, the team sends a preview link to Slack for a person to review. Questions or missing evidence come back for input before publication.

After approval and publication, the SEO analyst returns to the AEO tool to track visibility and recommend the next step. You.com supplies web research along the way, while Paperclip keeps the agents working toward a shared goal across research, writing, review, and follow-up.

Conclusion

Paperclip brings your AI agents together as one company, with an org chart, clear responsibilities, and shared goals. You.com gives those agents current web sources to search, read, and cite. Paperclip's task history keeps the work and review decisions in context, so you can see what the team produced and decide what happens next. The You.com connector brings the live web into that structure. Agents can search, read, and cite current sources on their own schedule, and every one of those calls lands in the same trace and audit log as the rest of their work. Teams get agents that know what happened this week, and a clear record of where that knowledge came from.

Connect You.com in Paperclip. Open Connectors, select You.com, and start on the free profile to see your agents search the live web today. Add an API key when they're ready to read full pages. The setup guide covers each step.

Frequently Asked Questions

No. The free profile works without credentials and includes you-search and you-discover, with 100 queries per day. Sign in or add an API key to add you-contents and you-balance.

Any agent in your Paperclip org, on any runtime Paperclip supports. You choose which agents have access when you set up the connection.

Yes. Set any tool to Ask first and each call waits for a person to approve it. You can loosen or tighten settings at any time.

Yes. Add the /mcp/research or /mcp/finance endpoint as a custom MCP server in Paperclip with your You.com API key.

    Share Article:

  1. LI Test

  2. LI Test

Related resources.

The You.com Sim Integration Brings Eight Web Search API Tools to Visual Agent Workflows

October 14, 2026

Blog

You.com Is Now a Connector in Merge Agent Handler

October 9, 2026

Blog

Retrieve, then judge.

October 2, 2026

Blog

Pydantic AI and You.com—Delivering Powerful Web Intelligence and Agent Orchestration

August 27, 2026

Blog

The Model Is the Cheapest Part of a Grounded Answer

August 13, 2026

Blog