> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nimbleway.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Copilot Studio
> Manually configure the Nimble MCP server as a tool in a Microsoft Copilot Studio agent
Microsoft Copilot Studio agents can call Nimble's web data toolkit — search, extract, map, crawl, and Web Search Agents — through the [Model Context Protocol (MCP)](https://modelcontextprotocol.io/). This page covers the manual setup: add the Nimble MCP server to an agent using the built-in MCP onboarding wizard.
## What you get
* **Nimble's web data toolkit** in any Copilot Studio agent — search, extract, map, crawl, and Web Search Agents
* **Dynamic tool discovery** — the agent picks up every Nimble MCP tool automatically; new tools appear without reconfiguration
* **OAuth 2.1 sign-in** — authenticate in the browser during setup; no API key to paste, manage, or rotate
* **Streamable HTTP transport** at `https://mcp.nimbleway.com/mcp`
## Prerequisites
* A **Microsoft Copilot Studio** environment with an agent you can edit ([licensing details](https://learn.microsoft.com/en-us/microsoft-copilot-studio/requirements-licensing-subscriptions))
* A **Nimble account** — [sign up free](https://online.nimbleway.com/signup). Sign-in happens through OAuth during setup; no API key to paste.
MCP routes tool results through the agent's context window and can consume tokens
quickly. For high-volume retrieval, consider the [Nimble API](/nimble-sdk/web-tools/search) directly.
## Add Nimble MCP to your agent
The MCP onboarding wizard is the fastest way to connect an existing MCP server. It lives inside Copilot Studio — no trip to Power Apps required.
In Copilot Studio, open your agent and go to the **Tools** page. Select **Add a tool**.
In the **Add tool** dialog, under **Create new**, select **Model Context Protocol**.
Fill in the server fields, then set authentication to **OAuth 2.0** with type **Dynamic discovery**. Nimble MCP supports OAuth 2.0 Dynamic Client Registration (DCR), so it advertises its endpoints automatically — there's nothing else to configure. Select **Create**.
| Field | Value |
| ---------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Server name** | `Nimble MCP` |
| **Server description** | `Nimble turns the live internet into structured, reliable data for AI — search, extract, map, and crawl any website, plus purpose-built Web Search Agents for your use case at scale.` |
| **Server URL** | `https://mcp.nimbleway.com/mcp` |
| **Authentication** | `OAuth 2.0` → `Dynamic discovery` |
The agent orchestrator uses the description to decide when to call Nimble — keep it clear and specific.
Copilot Studio creates the custom connector. On the **Add tool** dialog, open the **Connection** dropdown and select **Create new connection**.
A browser window opens to authorize with your Nimble workspace. Review the requested permissions — verify identity, maintain access when offline, search and extract, and manage Web Search Agents — and select **Approve**. Copilot Studio stores the tokens and refreshes them automatically.
Back on the **Add tool** dialog, select **Add and configure**. Copilot Studio discovers the Nimble tools and lists them under the agent's tools.
## Verify the connection
Open a test chat with your agent and send a prompt that forces a Nimble tool call:
```text theme={"system"}
Search the web for the latest Microsoft Build 2026 announcements,
then extract the full text of the top result as clean data.
```
The agent calls Nimble **Search**, then **Extract**, and returns results grounded in live web data. If the tools run and return content, the connection works end to end.
Expand the activity map in the test pane to confirm the agent invoked the Nimble tools (`nimble_search` and `nimble_extract`) rather than answering from its own knowledge.
## Resources
Full MCP server setup for Cursor, Claude, and other clients
One-click Nimble MCP install for VS Code with GitHub Copilot
Microsoft's docs for extending agents with MCP servers
Reference for the Search, Extract, Map, and Crawl APIs behind the tools