Can my AI agent manually index new pages?

Yes. If you provide the AddSearch Secret Key, your agent can use the `index_document` tool. You can supply a URL and a JSON payload containing the title and body, and the agent will push it directly into your live search index without waiting for the web scraper.

What kind of search analytics can I retrieve?

Using the Secret Key, your agent can call two analytics endpoints: `stats_queries` (to see what users searched for, including top searches and zero-result queries) and `stats_clicks` (to see the click-through rates and popular URLs users navigated to from the search bar).

Do I need the Secret Key if I just want to test search queries?

No, if your goal is solely to run searches, paginate results, or check auto-suggestions, the public 'Site Key' is completely sufficient. The Secret Key is only required to list all documents, modify the index, and fetch analytics.

AddSearch MCP Server for AutoGen 10 tools — connect in under 2 minutes

Name: AddSearch
Availability: InStock
Author: Vinkius

microsoft.github.io/autogen/docs/tools/mcp-tools

Built by Vinkius GDPR 10 Tools Framework

Microsoft AutoGen enables multi-agent conversations where agents negotiate, delegate, and execute tasks collaboratively. Add AddSearch as an MCP tool provider through Vinkius and every agent in the group can access live data and take action.

Get MCP Server for AI Agents

ASK AI ABOUT THIS MCP SERVER

Open in ChatGPT Open in Claude Open in Perplexity

Vinkius supports streamable HTTP and SSE.

python

import asyncio
from autogen_agentchat.agents import AssistantAgent
from autogen_ext.tools.mcp import McpWorkbench

async def main():
    # Your Vinkius token. get it at cloud.vinkius.com
    async with McpWorkbench(
        server_params={"url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"},
        transport="streamable_http",
    ) as workbench:
        tools = await workbench.list_tools()
        agent = AssistantAgent(
            name="addsearch_agent",
            tools=tools,
            system_message=(
                "You help users with AddSearch. "
                "10 tools available."
            ),
        )
        print(f"Agent ready with {len(tools)} tools")

asyncio.run(main())

Fully ManagedVinkius Servers

60%Token savings

High SecurityEnterprise-grade

IAMAccess control

EU AI ActCompliant

DLPData protection

V8 IsolateSandboxed

Ed25519Audit chain

<40msKill switch

Stream every event to Splunk, Datadog, or your own webhook in real-time

* Every MCP server runs on Vinkius-managed infrastructure inside AWS - a purpose-built runtime with per-request V8 isolates, Ed25519 signed audit chains, and sub-40ms cold starts optimized for native MCP execution. See our infrastructure

About AddSearch MCP Server

Connect your AddSearch account to your AI agent and turn your site's search index into an interactive, manageable database. Perfect for content teams and developers who need to audit site search performance without opening dashboards.

AutoGen enables multi-agent conversations where agents negotiate, delegate, and collaboratively use AddSearch tools. Connect 10 tools through Vinkius and assign role-based access. a data analyst queries while a reviewer validates, with optional human-in-the-loop approval for sensitive operations.

What you can do

Deep Search — Query your indexed content using natural language, apply custom field filters (e.g. "category=shoes"), or sort by custom variables
Document Management — List all indexed pages, import new content directly via JSON, or permanently delete outdated documents from the index
Search Analytics — Retrieve live statistics on user queries, identifying top searches, zero-result queries, and click-through rates
Frontend Emulation — Test your auto-suggestions and pagination just like a real user interacting with your search bar

The AddSearch MCP Server exposes 10 tools through the Vinkius. Connect it to AutoGen in under two minutes — no API keys to rotate, no infrastructure to provision, no vendor lock-in. Your configuration, your data, your control.

How to Connect AddSearch to AutoGen via MCP

Follow these steps to integrate the AddSearch MCP Server with AutoGen.

Install AutoGen

Run pip install "autogen-ext[mcp]"

Replace the token

Replace [YOUR_TOKEN_HERE] with your Vinkius token

Integrate into workflow

Use the agent in your AutoGen multi-agent orchestration

Explore tools

The workbench discovers 10 tools from AddSearch automatically

Why Use AutoGen with the AddSearch MCP Server

AutoGen provides unique advantages when paired with AddSearch through the Model Context Protocol.

Multi-agent conversations: multiple AutoGen agents discuss, delegate, and collaboratively use AddSearch tools to solve complex tasks

Role-based architecture lets you assign AddSearch tool access to specific agents. a data analyst queries while a reviewer validates

Human-in-the-loop support: agents can pause for human approval before executing sensitive AddSearch tool calls

Code execution sandbox: AutoGen agents can write and run code that processes AddSearch tool responses in an isolated environment

AddSearch + AutoGen Use Cases

Practical scenarios where AutoGen combined with the AddSearch MCP Server delivers measurable value.

Collaborative analysis: one agent queries AddSearch while another validates results and a third generates the final report

Automated review pipelines: a researcher agent fetches data from AddSearch, a critic agent evaluates quality, and a writer produces the output

Interactive planning: agents negotiate task allocation using AddSearch data to make informed decisions about resource distribution

Code generation with live data: an AutoGen coder agent writes scripts that process AddSearch responses in a sandboxed execution environment

AddSearch MCP Tools for AutoGen (10)

These 10 tools become available when you connect AddSearch to AutoGen via MCP:

autosuggest

Get autocomplete suggestions

delete_document

Requires Secret Key. Permanently delete a document

index_document

Requires Secret Key. Add or update an indexed document

list_documents

Requires Secret Key. List all indexed documents

search_filtered

g., "category=shoes", "brand=nike"). Search indexed content by custom field

search_keyword

Search indexed content by keyword

search_pagination

Retrieve a specific page of search results

search_sorted

Search indexed content with custom sort

stats_clicks

Requires Secret Key. Retrieve click-through analytics

stats_queries

Requires Secret Key. Retrieve search query analytics

Example Prompts for AddSearch in AutoGen

Ready-to-use prompts you can give your AutoGen agent to start working with AddSearch immediately.

"Show me the top search queries that resulted in 0 hits."

"Search my site for "pricing updates" filtered by category=news."

"Test the auto-suggest for the prefix "shoe"."

Troubleshooting AddSearch MCP Server with AutoGen

Common issues when connecting AddSearch to AutoGen through the Vinkius, and how to resolve them.

McpWorkbench not found

Install: pip install "autogen-ext[mcp]"

AddSearch + AutoGen FAQ

Common questions about integrating AddSearch MCP Server with AutoGen.

How does AutoGen connect to MCP servers?

Create an MCP tool adapter and assign it to one or more agents in the group chat. AutoGen agents can then call AddSearch tools during their conversation turns.

Can different agents have different MCP tool access?

Yes. AutoGen's role-based architecture lets you assign specific MCP tools to specific agents, so a querying agent has different capabilities than a reviewing agent.