- Sign in with your Bridgly account. Clients that support OAuth, such as Claude and ChatGPT, only need the server URL. They open a Bridgly page where you sign in and approve access. See Sign in with your account.
- Use an API key. Send your Bridgly API key (
bgly_…) as a bearer token, just like the REST API. See Connect with an API key.
billing_get_info does not consume credits.
Sign in from your AI app
In your AI app, addhttps://mcp.bridgly.app/mcp as a custom connector, choose
Connect, then sign in to Bridgly in the browser page that opens and allow
access. See Sign in with your account for steps for each client,
what a connected app can do, and how to disconnect one.
Connect with an API key
Need a key? Create one on the API Keys page of your
dashboard. Keep the key private and out of
shared configuration files — anyone with it can spend your credits.
- Claude Code
- Cursor
- Claude Desktop
- Codex
Add the server from the CLI:Then start a session and ask it to fetch a public profile or search for posts
— the Bridgly tools appear automatically.
Available tools
The tool catalogue covers Bridgly’s published scraping API across all supported platforms. Tools are generated from the API’s route registry, so newly supported endpoints become available without a separate MCP integration.Profiles & accounts
Fetch public profiles, company details, and account activity using the tools
available for each platform.
Posts & discussions
Retrieve posts, comments, reply threads, and community content for research
and analysis.
Search & discovery
Find people, posts, jobs, companies, and more with the search tools each
platform supports.
/x/get-user becomes x_get_user, and
/linkedin/search/jobs becomes linkedin_search_jobs. Each tool exposes the same
input fields and descriptions as its matching API endpoint, helping your client
choose the right tool and supply its arguments.
Each scraping tool’s description states what a call costs. In general, one call
costs one credit.
The account tool billing_get_info returns your current spendable credit
balance and billing settings. It takes no arguments.
How results come back
Successful calls return the matching API response as JSON text. Scraping results use the{ timeMs, creditsCost, data } envelope: data contains the result,
creditsCost reports the credits used, and timeMs reports the request duration.
The billing_get_info tool returns the account’s billing snapshot instead.
If a call fails, the server marks the tool result as an error and includes a
message describing the problem, such as invalid arguments, an invalid API key,
or insufficient credits. Your client can use that message to decide what to do
next.
Security notes
Stateless by design
Each request is handled in isolation and bound only to the key you send. No
session state is shared between callers.
Your key, your credits
Scraping calls use the credit balance of the account the key belongs to.
Create a separate key for each integration so you can revoke one without
interrupting clients that use other keys.