# Oportunidados

> Oportunidados is a paid MCP server for sales and crm. Search Brazilian companies by CNPJ and manage your Oportunidados CRM from an AI assistant. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Paid
- **Platforms:** API, Web
- **Website:** https://oportunidados.com.br/ajuda/api/mcp-da-oportunidados
- **Repository:** https://github.com/atmosphere-technologies/atmosphere_app/tree/HEAD/mcp/oportunidados
- **MCP Registry name:** br.com.oportunidados/mcp
- **Categories:** sales and CRM, analytics and data
- **Listing updated:** 2026-11-16

## About

The server brings a Brazilian company database and the account's CRM into an assistant that is asked in Portuguese. It has 24 tools: four for companies (search with filters, a record by CNPJ, a search filter generated from a text description, and filter code metadata), one for the account and plan, and a set for the CRM covering organizations, contacts, pipelines, deals and notes, including bulk creation of deals from CNPJs.

Login is OAuth only with an Oportunidados account, with no API token. Four permissions apply: brazilian_companies_read, account_read, crm_read and crm_write. Each user reaches only their own company's data. It works on paid subscription plans at no extra cost, while trial or unpaid accounts get a 403.

Company searches, CNPJ lookups and filter generation share the plan's monthly API call quota, one per call, while CRM, account and filter-code tools do not use it. The company record masks partner CPF numbers and does not list branches. Writes change real CRM data, so approvals should be reviewed.

## Features

- **Company search:** Search Brazilian companies with filters or natural-language descriptions.
- **CNPJ record:** Fetch a company's full record by CNPJ.
- **CRM read and write:** Manage organizations, contacts, pipelines, deals and notes.
- **Bulk deal creation:** Create deals in batch from a list of CNPJs.
- **OAuth permissions:** Four scopes separate reading from CRM writing.
- **Monthly quota:** Search and lookup calls count against the plan quota.

## Good for

- Find companies in a segment and add them to a CRM pipeline
- Look up a company's record by CNPJ
- Generate a search filter from a plain description
- Log notes against an organization from chat

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http mcp https://mcp.oportunidados.com.br/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://mcp.oportunidados.com.br/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mcp": {
      "url": "https://mcp.oportunidados.com.br/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "mcp": {
      "type": "http",
      "url": "https://mcp.oportunidados.com.br/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "mcp": {
      "serverUrl": "https://mcp.oportunidados.com.br/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "mcp": {
      "type": "http",
      "url": "https://mcp.oportunidados.com.br/mcp"
    }
  }
}
```

## Tools

- `search_brazilian_companies`: Search companies with filters.
- `get_brazilian_company`: Fetch one company by CNPJ.
- `generate_brazilian_companies_filter`: Generate a search filter from a text description.
- `get_search_metadata`: List filter codes.
- `get_account`: Show the account and plan.
- `upsert_crm_organization_by_cnpj`: Create or update a CRM organization by CNPJ.
- `bulk_create_crm_items_from_list`: Create deals in bulk from CNPJs.
- `create_crm_note`: Add a note in the CRM.

## FAQ

### Do I need an API token?

No. Login is OAuth with your Oportunidados account.

### Which plans can use it?

Paid plans with an active subscription; trials and overdue accounts receive a 403.

### Can the assistant delete CRM data?

Yes with the crm_write permission, so review writes before approving.

### What counts against the quota?

Company search, CNPJ lookup and filter generation; CRM tools do not.

### Is Oportunidados free?

No. Oportunidados is a paid product.

### How do I add Oportunidados to Claude Code?

Run this command in your terminal: claude mcp add --transport http mcp https://mcp.oportunidados.com.br/mcp

### What are the best alternatives to Oportunidados?

The closest alternatives to Oportunidados are Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP, Tapetide - Indian Stock Market MCP, World Monitor and Calven.

## Alternatives

- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [World Monitor](https://ai-powered.com/mcp/world-monitor): World Monitor is a freemium MCP server for analytics and data.
- [Calven](https://ai-powered.com/mcp/calven): Calven is an MCP server for marketing and seo.
- [CompanyData](https://ai-powered.com/mcp/companydata): CompanyData is a paid MCP server for analytics and data.
- [MisarReach MCP Server](https://ai-powered.com/mcp/misarreach-mcp-server): MisarReach MCP Server is a freemium MCP server for sales and crm.
- [NeuralVerge](https://ai-powered.com/mcp/neuralverge): NeuralVerge is an MCP server for web search and scraping.

---
Source: https://ai-powered.com/mcp/oportunidados
