SpinAI App
@KaranThink41
Integration of SpinAi Agent with Hubspot Mcp server
Overview
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.
