Pin tools

By default, an agent sees a handful of general tools and searches for the endpoint it needs. If you always use the same platforms, pin them: each of their endpoints becomes a tool of its own, with its exact input, ready to call.

Pin platforms or endpoints

Add them to the server address:

https://data.upscrape.com/mcp?platforms=amazon,googlemaps

https://data.upscrape.com/mcp?capabilities=amazon.products.search,amazon.product.get

Every platform's reference page gives its pin address under "At a glance".

What the agent sees

The pinned endpoints are added to the general tools. Each is named after its endpoint ID, with every dot made a double underscore, because some apps don't allow dots in tool names:

amazon.products.search  ->  amazon__products__search

A pinned tool takes the endpoint's input directly and waits for the result. Its run options go in _upscrape; see Tools.

When to pin

• The agent struggles to find the right endpoint by searching.

• You use a small, steady set of endpoints.

• Your app remembers tool lists and you want a short, fixed one.

After changing what you pin, remove the server in your app and add it again so the app reloads the tools.

Every endpoint as a tool

profile=catalog turns every endpoint your account can use into a tool. That is hundreds of tools: use it only in an app that searches its tools itself, or the list will swamp it.

https://data.upscrape.com/mcp?profile=catalog

Pinning is not a limit

Pinning chooses what the agent sees first, not what it may do: the general tools can still run any endpoint. To restrict an agent, limit its access when you connect, or limit its API key.