Agent.AI MCP Server

Agent.AI MCP Server

This is an externally deployable version of the Agent.AI MCP Server, designed to be hosted on Vercel and called from other applications.

Deployment Instructions

Prerequisites

• GitHub account
• Vercel account (free tier works)
• Git installed locally

Steps to Deploy

1. Create a new GitHub repository

   git init
   git add .
   git commit -m "Initial commit: Agent.AI MCP Server"
   git branch -M main
   git remote add origin https://github.com/YOUR_USERNAME/agentai-mcp-server.git
   git push -u origin main
   

2. Deploy to Vercel

   • Go to vercel.com
   • Click "New Project"
   • Import your GitHub repository
   • Vercel will automatically detect it as a Node.js project
   • Click "Deploy"

3. Get your deployment URL

   • After deployment, Vercel will provide a URL like: https://your-project-name.vercel.app
   • This is your MCP server endpoint

Usage

Once deployed, you can call your MCP server from other applications using the Vercel URL.

Example Usage

// In your other app
const mcpServerUrl = 'https://your-project-name.vercel.app';

// Make requests to your MCP server
fetch(mcpServerUrl + '/your-endpoint')
  .then(response => response.json())
  .then(data => console.log(data));

Local Development

To run locally:

npm install
npm start

The server will start on http://localhost:3000

Configuration

• Port: Automatically set by Vercel, or defaults to 3000 locally
• Environment Variables: Can be set in Vercel dashboard under Project Settings > Environment Variables

Troubleshooting

• Ensure your @agentai/mcp-server package is publicly available
• Check Vercel deployment logs if issues occur
• Verify your GitHub repository is public or Vercel has access

Important: Authentication Setup

1. Configure Agent.AI API Token

Your MCP server requires an Agent.AI API token to authenticate with Agent.AI services:

1. Get your API token from Agent.AI
2. Go to your Vercel project dashboard
3. Click "Settings" → "Environment Variables"
4. Add a new variable:
   • Name: API_TOKEN
   • Value: Your Agent.AI API token
5. Redeploy the project

2. Disable Vercel Authentication

To allow external access to your MCP server, you MUST disable Vercel's built-in authentication:

1. Go to your Vercel project dashboard
2. Click "Settings" → "Security"
3. Disable "Password Protection" and "Vercel Authentication"
4. Save changes

3. Test Authentication

After setup, your endpoints will return:

• ✅ "authentication": "configured" - Ready to use
• ❌ "authentication": "missing" - API_TOKEN required