DocsAI agents & MCPMCP server

MCP server

Give Claude, ChatGPT, Cursor and other agents live access to Provly.

Provly runs a remote Model Context Protocol server. Agents get the whole API as tools, and each tool call counts as one request against your plan.

Server URL

https://provly.co/api/v1/mcp

Transport: Streamable HTTP (stateless JSON responses)
Auth: OAuth 2.1 sign-in (browser apps like ChatGPT and claude.ai) or Authorization: Bearer pvly_live_… (Claude Code, Cursor, scripts)
Protocol: 2025-06-18, 2025-03-26 and 2024-11-05

Claude

Claude Code, Claude Desktop and claude.ai

ChatGPT

Custom connectors and the Responses API

Cursor & Windsurf

One mcp.json entry

n8n & Zapier

Automations over REST or MCP

Tools#

Tool	Does
`lookup`	Brand / domain / @handle → advertiser and shop ids. Call first.
`list_facets`	Valid values of every filter
`search_ads`	Ads by keyword, platform or network, niche, country, run time
`get_ad`, `get_ad_media_url`, `get_similar_ads`	One ad, its media file, look-alike creatives
`search_advertisers`, `get_advertiser`, `get_advertiser_ads`	Brands and their ads
`search_shops`, `get_shop`, `get_shop_ads`, `get_shop_products`, `get_similar_shops`	Stores, tech stack, ads, products, competitors
`search_products`, `get_product`	Product research with presets
`search_emails`, `get_email`	Marketing emails
`list_trackers`, `get_tracker_ads`, `track_brand`, `untrack`	Spyder trackers
`list_boards`, `create_board`, `update_board`, `delete_board`, `list_board_items`, `save_ad_to_board`, `remove_ad_from_board`	Swipe-file boards
`get_usage`, `get_workspace`, `get_freshness`	Limits and data freshness

Every OAuth connection acts as a workspace API key: revoking the key in Settings → API disconnects the app. Tools that change the account (track_brand, untrack, board writes) are marked as non-read-only, so clients ask you before running them.

Test it by hand#

bash

curl -X POST https://provly.co/api/v1/mcp \
  -H "Authorization: Bearer $PROVLY_API_KEY" -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'