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
-
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 -
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"
-
Get your deployment URL
- After deployment, Vercel will provide a URL like:
https://your-project-name.vercel.app - This is your MCP server endpoint
- After deployment, Vercel will provide a URL like:
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-serverpackage 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:
- Get your API token from Agent.AI
- Go to your Vercel project dashboard
- Click "Settings" → "Environment Variables"
- Add a new variable:
- Name:
API_TOKEN - Value: Your Agent.AI API token
- Name:
- Redeploy the project
2. Disable Vercel Authentication
To allow external access to your MCP server, you MUST disable Vercel's built-in authentication:
- Go to your Vercel project dashboard
- Click "Settings" → "Security"
- Disable "Password Protection" and "Vercel Authentication"
- Save changes
3. Test Authentication
After setup, your endpoints will return:
- ✅
"authentication": "configured"- Ready to use - ❌
"authentication": "missing"- API_TOKEN required