Look 4 Fundings - EU Funding Crawler MCP Server

A Model Context Protocol (MCP) server that provides tools for searching EU funding opportunities and managing company funding data through the Look 4 Fundings web application. This server integrates with both the official EU Funding & Tenders Portal API and the Look 4 Fundings web platform.

Features

• EU Funding Search: Search for active EU funding opportunities by keyword

• Company Profile Management: Retrieve company information for better funding recommendations

• Grant Management: Add funding opportunities to the web application with custom affinity scores

• Professional Reports: Generate PDF reports from company data and won grants

• Report Generation: Create both generated reports (from website data) and API reports (from custom content)

• Comprehensive Data: Get detailed information including title, summary, deadline, budget, and status

• Dual API Integration: Uses both the official EU Funding & Tenders Portal API and the Look 4 Fundings web API

• Le Chat Integration: Compatible with Le Chat's MCP connector system

Prerequisites

• Python 3.12 or higher

• uv package manager

Installation

1. Clone or download this repository

2. Install dependencies using uv:

Running the Server

Method 1: Direct Python Execution

Run the server directly with Python:

The server will start on http://localhost:3000 and use the streamable-http transport for Le Chat compatibility.

Method 2: Using LocalTunnel for External Access

To expose your local server to the internet (required for Le Chat integration), use lt (LocalTunnel):

1. Install LocalTunnel globally:

2. In one terminal, start the MCP server:

3. In another terminal, expose the server using LocalTunnel:

This will provide you with a public URL like https://legal-bugs-chew.loca.lt that you can use to connect to your MCP server.

Le Chat Integration

To connect this MCP server to Le Chat:

1. Start your MCP server using one of the methods above

2. If using LocalTunnel, note the provided URL (e.g., https://legal-bugs-chew.loca.lt)

3. In Le Chat, go to the connectors section

4. Add a new MCP connector with the URL: https://your-tunnel-url.loca.lt/mcp

5. The server will be available for use in Le Chat

Available Tools

search_eu_fundings

Searches for EU funding opportunities by keyword and returns detailed funding information.

Parameters:

• keyword (str): The search keyword (e.g., "AI", "machine learning", "renewable energy") - defaults to "AI"

• page_size (int): Number of results to return per page - defaults to 20

Returns:

• List[PublicFunding]: A list of PublicFunding objects containing:

  • title (str): Title of the funding opportunity

  • url (str): Direct link to the funding page

  • summary (str): Summary/objective of the funding

  • deadline (date): Application deadline

  • status (str): Current status of the funding

  • budget (str): Budget information with currency

  • company_affinity (float): Company affinity score (0-100)

  • won (bool): Whether the grant was won or not (default: False)

Example:

Note: Returns an empty list if no results are found or if an error occurs during the API request.

get_company_profile

Retrieves the company profile information from the Look 4 Fundings web application.

Parameters:

• None

Returns:

• Optional[MyCompany]: The company profile object containing:

  • name (str): Name of the company

  • url (str): Direct link to the company's website

  • scope (str): Description of the company's scope/activities

Example:

Note: Returns None if no company profile is set or if there's an error fetching the data.

add_grant_with_affinity

Adds a new grant to the Look 4 Fundings web application with a specified affinity score.

Parameters:

• funding (PublicFunding): The funding opportunity object to add

• affinity_score (float): The company affinity score (0-100) for this funding opportunity

Returns:

• Optional[PublicFunding]: The created funding object with updated affinity score, or None if there's an error

Example:

Note: The function validates that the affinity score is between 0 and 100. The funding object is automatically updated with the new affinity score before being posted to the web application. The won field is preserved from the original funding object.

get_grants

Retrieves all grants currently listed in the Look 4 Fundings web application.

Parameters:

• None

Returns:

• List[PublicFunding]: A list of all PublicFunding objects currently in the application, including their won status

Example:

Note: Returns an empty list if no grants are found or if there's an error. The function automatically converts date strings back to date objects for proper data handling.

generate_company_report

Generates a professional PDF report for the company using profile and grants data.

Parameters:

• report_content (str): Optional custom report content. If empty, generates report from website data (company profile + won grants)

Returns:

• Optional[dict]: Report generation result with download URL and details, or None if error

Report Types:

• Generated Reports: Automatically created from company profile and won grants data

• API Reports: Created from custom LLM-generated content

Example:

Note: The tool automatically determines the report type based on whether content is provided. Generated reports include company information, grant statistics, and won grants details. API reports use the provided custom content.

Development

This project uses:

• FastMCP: For building the MCP server

• Streamable HTTP: For Le Chat compatibility

• Python 3.12+: For modern Python features

• Pydantic: For data validation and serialization

• Requests: For HTTP API calls to the EU Funding Portal

• HTTPX: For HTTP API calls to the Look 4 Fundings web application

• ReportLab: For PDF report generation

• EU Funding & Tenders Portal API: Official REST API for funding data

• Look 4 Fundings Web API: Custom web application API for grant management and reports

Project Structure

• main.py: MCP server setup and tool definitions

• crawler.py: EUFundingCrawler class for API interactions

• type.py: Pydantic models for data structures

• pyproject.toml: Project dependencies and configuration

Troubleshooting

• Port already in use: If port 3000 is occupied, you can modify the port in main.py and update the LocalTunnel command accordingly

• LocalTunnel issues: Make sure LocalTunnel is installed globally and the tunnel URL is accessible

• Le Chat connection: Ensure the MCP endpoint URL includes /mcp at the end

• API errors: The crawler uses the official EU API which may have rate limits or temporary unavailability

• No results found: Try different keywords or check if the API is responding correctly

• Date serialization errors: The add_grant_with_affinity tool automatically handles date conversion for JSON serialization

• Web API connection: Ensure the Look 4 Fundings web application is accessible at https://web-production-08f4.up.railway.app/

• Affinity score validation: The affinity score must be between 0 and 100, inclusive

• Report generation errors: Ensure the web application has ReportLab installed and the reports API is accessible

• PDF download issues: Reports are generated server-side and downloaded via the web application's download endpoint

License

This project is open source and available under the MIT License.