MCP Activities

A Model Context Protocol (MCP) server that allows Cursor to interact with the meupontoonline system to create activities. The server is deployed on Railway and supports both local development and cloud deployment.

Features

Create activities with start date, end date, and description
Automatic DTO transformation according to the meupontoonline API format
Form-data submission to the meupontoonline API
HTTP transport for cloud deployment
TypeScript support for development

Installation

Clone or download this project
Install dependencies:

npm install

Usage

Running the MCP Server

Local Development

Start the server in development mode:

npm run dev

Or start in production mode:

npm start

Railway Deployment

The server is deployed on Railway and accessible via HTTP transport.

Cursor Integration

To use this MCP server with Cursor, follow these steps:

Method 1: Railway Deployment (Recommended)

Open Cursor
Go to Settings → Features → Model Context Protocol
Add a new server with this configuration:

{
  "mcpServers": {
    "mcp-activities": {
      "url": "https://mcp-activities.up.railway.app/mcp"
    }
  }
}

Method 2: Local Development

For local development, use this configuration:

{
  "mcpServers": {
    "mcp-activities": {
      "url": "http://localhost:3000/mcp"
    }
  }
}

Troubleshooting

For Railway deployment: Ensure the URL is correct and the server is running
For local development: Ensure Node.js is installed and accessible from PATH
Verify the file paths are correct for your system
Check that all dependencies are installed with npm install
Restart Cursor after adding the configuration
Build the project with npm run build before running locally

Available Tools

create_activity

Creates a new activity in the meupontoonline system.

Parameters:

startDate (string, required): Start date and time in ISO format (YYYY-MM-DDTHH:mm:ss or YYYY-MM-DD HH:mm)
endDate (string, required): End date and time in ISO format (YYYY-MM-DDTHH:mm:ss or YYYY-MM-DD HH:mm)
project (string, required): Project name
description (string, required): Activity description
email (string, required): Login email for meupontoonline
password (string, required): Login password for meupontoonline

Example usage in Cursor:

Create an activity from 2025-01-15 09:00 to 2025-01-15 17:00 for project "Frontend Development" with description "Component Implementation" using email "user@example.com" and password "password123"

DTO Transformation

The server automatically transforms user input to the required DTO format:

Input:

Start Date: 2025-01-15T09:00:00
End Date: 2025-01-15T17:00:00
Description: "Project Development - Frontend Implementation"

Transformed DTO:

{
  "dataLancamento": "2025-01-15 09:00",
  "horarioInicio": "09:00:00",
  "horarioFim": "17:00:00",
  "observacao": "",
  "idTarefa": 233,
  "detalheTarefa": "Project Development - Frontend Implementation"
}

Authentication

The server requires authentication to access the meupontoonline API. The login process:

Login Request: Sends credentials to https://app.meupontoonline.com/Login/RealizaLogin
Cookie Extraction: Extracts authentication cookies from the response
Session Management: Uses cookies for subsequent API requests

Required Credentials:

email: Your meupontoonline login email
password: Your meupontoonline login password

API Integration

The server sends the transformed DTO as form-data to:

URL: https://app.meupontoonline.com/Lancamentos/Create
Method: POST
Content-Type: multipart/form-data
Authentication: Uses cookies from login session

Error Handling

The server includes comprehensive error handling for:

Missing required parameters
Invalid date formats
End date before start date
Authentication failures (invalid credentials)
API request failures
Network errors
Session expiration

Development

Project Structure

mcp-activities/
├── src/
│   ├── index.ts          # Main MCP server implementation (TypeScript)
│   └── tools/            # Tool implementations
├── dist/                 # Compiled JavaScript output
├── dto-template.json     # DTO template reference
├── package.json          # Project configuration
├── tsconfig.json         # TypeScript configuration
└── README.md            # This file

Scripts

npm run build: Compile TypeScript to JavaScript
npm run dev: Run in development mode with hot reload
npm start: Run compiled version
npm run dev:watch: Run with file watching

Dependencies

@modelcontextprotocol/sdk: MCP server framework
express: HTTP server framework
axios: HTTP client for API requests
typescript: TypeScript compiler
tsx: TypeScript execution environment

Author

Yohan Fraga Santos