SpinAI App

What is SpinAI App?

SpinAI App is a TypeScript-based application that integrates AI capabilities using OpenAI and other AI services, with a focus on HubSpot integration. It uses an Express.js backend and is configured for the Model Context Protocol (MCP). This server is intended for developers who want to combine AI-powered workflows with HubSpot data.

How to use SpinAI App?

Clone the repository, install dependencies with npm or yarn, copy .env.example to .env, and populate the required environment variables (OPENAI_API_KEY, HUBSPOT_ACCESS_TOKEN, SHARED_CONTACT_ID). Run the development server with npm run dev, build for production with npm run build, and start the production server with npm run start.

Key features of SpinAI App

• AI-powered functionality using OpenAI
• Integration with HubSpot
• Modern TypeScript development setup
• Express.js backend
• Environment-based configuration
• Model Context Protocol (MCP) support via mcp-config.ts

Use cases of SpinAI App

• Enrich HubSpot contacts with AI-generated insights.
• Automate CRM tasks using natural language prompts.
• Build a custom AI assistant that interacts with HubSpot data.
• Prototype MCP-based AI agents for sales or support workflows.

FAQ from SpinAI App

What prerequisites are needed?

Node.js v18 or higher, npm or yarn, an OpenAI API key, and a HubSpot access token.

What environment variables are required?

OPENAI_API_KEY, HUBSPOT_ACCESS_TOKEN, and SHARED_CONTACT_ID. These are configured in a .env file.

How does data flow work?

The application reads credentials from environment variables and communicates with OpenAI and HubSpot APIs. No local database is mentioned; data lives in HubSpot and is processed in memory.

Is there a development server with hot-reloading?

Yes, run npm run dev to start a development server with hot-reloading enabled.

What is the project structure?

Source code is in src/, environment variables in .env, an MCP configuration file (mcp-config.ts) at the root, and standard TypeScript/Node.js configuration files.