Tracxn MCP

🚀 Tracxn MCP Server

A Model Control Protocol (MCP) server implementation for interfacing with the Tracxn API. This server enables AI models to access Tracxn's comprehensive corporate database, including companies, investors, transactions, and market intelligence.

🚀 Quick Start

Prerequisites

• Python 3.8 or higher
• Tracxn API access token

Installation

1. Clone the repository:

git clone 
cd tracxn-mcp

2. Install the dependencies:

pip install -r requirements.txt

3. Set your Tracxn API token:

# On macOS/Linux
export TRACXN_ACCESS_TOKEN="your-token-here"

# On Windows Command Prompt
set TRACXN_ACCESS_TOKEN=your-token-here

# On Windows PowerShell
$env:TRACXN_ACCESS_TOKEN="your-token-here"

Usage

Run the server:

python tracxn_server.py

✨ Features

Company Information

• Search for companies by industry, name, or domain.
• Filter by funding amount, location, or founding year.
• Detailed company profiles, including business models and funding history.

Investment Data

• Search for funding transactions and rounds.
• Filter by date, amount, or round type.
• Get investor details and portfolio information.

Market Intelligence

• Practice area insights.
• Business model classifications.
• Industry feeds and sectors.

📦 Installation

The installation steps are detailed in the "Quick Start" section above.

💻 Usage Examples

Basic Usage

The basic usage is to run the server as shown in the "Quick Start" section:

python tracxn_server.py

Advanced Usage

The server provides a variety of tools for different use - cases:

1. search_companies: Search for companies using various filtering criteria.
2. company_lookup: Get detailed information about a specific company.
3. funded_companies: Find companies within a specific funding range.
4. search_companies_by_name: Search for companies by name.
5. search_transactions: Find funding rounds and transactions.
6. search_investors: Search for investors and their portfolios.
7. search_acquisitions: Find acquisition transactions.
8. search_practice_areas: Explore practice areas.
9. search_feeds: Access industry feeds.
10. search_business_models: Find business model classifications.
11. debug_api_call: Debug API calls.
12. diagnose_api_request: Diagnose API request format issues.

📚 Documentation

API Endpoints

The server uses Tracxn's API v2.2, covering both playground and production environments:

• Playground: https://platform.tracxn.com/api/2.2/playground
• Production: https://platform.tracxn.com/api/2.2

Known Issues and Limitations

• Each request returns a maximum of 20 results.
• Some industries may require specific access permissions.
• Rate limits are applied to API calls.
• Sort fields must be specified in a particular format.
• The following errors may occur:
  • Sort field errors: Some endpoints require specific sort field formats.
  • Domain format issues: Company queries may require domains as a list or string.
  • Invalid industry access: Some industries may be inaccessible due to API permissions.

Error Handling

The server handles various API response codes:

• 200: Success
• 400: Bad request
• 401: Authentication issue
• 403: Unauthorized/Credit limit exhausted
• 404: Not found
• 429: Rate limit reached
• 500: Internal server error

Development

Project Structure

• tracxn_server.py: The main server implementation file.
• requirements.txt: Python dependencies.
• Other folders and files: Project - related resources.

How to Contribute

1. Clone the repository.
2. Create a feature branch.
3. Commit your changes.
4. Push to the remote repository.
5. Create a pull request.

📄 License

(Please specify the project license information here)

👥 Contributors

(List all contributors here)

⚠️ Important Note

This project is currently under active development. Some features may be incomplete or subject to change.