mcp-server-bigboost
The mcp-server-bigboost provides a standardized interface for querying data from Bigboost API using the Model Context Protocol. It facilitates access to personal and company data through integration with language models like Claude. The server follows SOLID design principles and supports high-volume requests with specific limitations.
mcp-server-bigboost
MCP (Model Context Protocol) server for integration with Bigdatacorp's Bigboost API. This server enables language models like Claude to access Bigboost API data in a standardized manner, allowing queries for individual and company data through various search parameters.
Requirements
- Node.js 18 or higher
- npm or yarn
- Bigboost API credentials (AccessToken and TokenId)
Project Structure
The project includes directories for configuration, constants, services, MCP tools, type definitions, utilities, and test files.
Configuration
- Clone the repository
- Install dependencies
- Copy and configure the
.envfile with credentials
Execution
Run the server in stdio mode for direct integration with language models like Claude.
Limitations
- Request limit of 5000 per 5 minutes per IP
- 30-second timeout for each request
Technical Features
- SOLID and SDR design principles
- Various status codes for API response
Integration
Supports integration with Windsurf, Claude, and other language models for data querying.
Tools Available
- consultaPessoa: Retrieves basic personal data by CPF
- consultaPessoaTelefone: Retrieves personal data by phone number
- consultaPessoaEmail: Retrieves personal data by email address
- consultaEmpresa: Retrieves company data by CNPJ
- consultaQsa: Retrieves a company's Shareholder and Administrative Framework
- consultaRegistroEmpresa: Retrieves comprehensive company registration data