# BigPicture.io — how to use (mcp.ai)

Connect your BigPicture.io account and use 4 tools for business intelligence straight from your AI agent. Connect with your own API key. BigPicture.io provides APIs and datasets for accessing comprehensive company data, including information on over 20 million profiles, used in applications like fintech products, cybersecurity, market research, and sales & marketing tools.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_bigpicture_io?ms=1787291400000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `bigpicture_io_company_find`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/bigpicture_io`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/bigpicture_io/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/bigpicture_io/company/find` — Tool to lookup company data by domain name. Use when you need detailed company profile by providing a website domain. Use after confirming domain correctness.
  - body: { domain: string }
- `POST https://api.mcp.ai/api/bigpicture_io/find/company/stream` — Tool to lookup company data by domain with streaming response. Holds connection open until data is ready, avoiding 202 async responses. Use when you need immediate company data without async polling. 
  - body: { domain: string }
- `POST https://api.mcp.ai/api/bigpicture_io/ip/to/company` — Lookup company information by IP address using BigPicture's IP-to-Company API. Returns detailed company data including: - Company name, domain, description, and legal name - Geographic location of the
  - body: { ip: string }
- `POST https://api.mcp.ai/api/bigpicture_io/name/to/domain/search` — Tool to find company domain(s) by company name. Use when you have a company name and need up to 3 likely domains.
  - body: { name: string }

## Example prompts
- "What can I do in BigPicture.io?"
- "Show me a summary of my BigPicture.io account"

## More
- Page: https://mcp.ai/bigpicture_io
- Agent spec (llms.txt): https://mcp.ai/bigpicture_io/llms.txt
- Postman collection: https://mcp.ai/bigpicture_io/postman.json