What is Agentai Mcp Server

agentai-mcp-server is an implementation of an MCP server that integrates with the Agent.ai API, offering functionalities such as web text extraction, web screenshots, and YouTube transcript retrieval through a dynamic function loading system.

Use cases

Use cases include extracting text from web pages for analysis, capturing screenshots for documentation, retrieving transcripts from educational YouTube videos, and automating data collection for research purposes.

How to use

To use agentai-mcp-server, you need to obtain an API token from Agent.ai. You can run the server using Docker or NPX by configuring the respective commands in your setup, ensuring to include your API token.

Key features

Key features include dynamic function loading from the Agent.ai API, web text extraction, web screenshot capture, YouTube transcript extraction, and efficient caching of function definitions to minimize API calls.

Where to use

agentai-mcp-server can be used in various fields such as web scraping, content analysis, digital marketing, and educational technology, where extracting and processing web content is essential.

Agent.ai MCP Server

An MCP server implementation that integrates with the Agent.ai API, providing web text extraction, web screenshots, and YouTube transcript capabilities through a dynamic function loading system.

Features

• Dynamic Function Loading: Automatically fetches available functions from Agent.ai API
• Web Text Extraction: Scrape or crawl web pages for text content
• Web Screenshots: Capture visual screenshots of web pages
• YouTube Transcripts: Extract transcripts from YouTube videos
• Caching: Efficient caching of function definitions to reduce API calls

Tools

The server dynamically loads tools from the Agent.ai API. The currently available tools include:

• grab_web_text

  • Extract text content from web pages
  • Inputs:
    • url (string, required): URL of the web page to extract
    • mode (string, optional): “scrape” for one page, “crawl” for up to 100 pages

• grab_web_screenshot

  • Capture visual screenshots of web pages
  • Inputs:
    • url (string, required): URL of the web page to capture
    • ttl_for_screenshot (integer, optional): Cache expiration time in seconds

• get_youtube_transcript

  • Fetch transcripts from YouTube videos
  • Inputs:
    • url (string, required): URL of the YouTube video

and dozens of other tools. To see all available tools, visit https://docs.agent.ai/api-reference.

Configuration

Getting an API Token

To use this MCP server, you’ll need an Agent.ai API token. Contact Agent.ai to obtain your token.

Usage with Claude Desktop

Add this to your claude_desktop_config.json:

Docker

{
  "mcpServers": {
    "agentai": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "API_TOKEN",
        "mcp/agentai"
      ],
      "env": {
        "API_TOKEN": "YOUR_API_TOKEN_HERE"
      }
    }
  }
}

NPX

{
  "mcpServers": {
    "agentai": {
      "command": "npx",
      "args": [
        "-y",
        "@agentai/mcp-server"
      ],
      "env": {
        "API_TOKEN": "YOUR_API_TOKEN_HERE"
      }
    }
  }
}

API Usage Examples

Extract Web Text

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: '{"url":"https://agent.ai","mode":"scrape"}'
};

fetch('https://api-lr.agent.ai/v1/action/grab_web_text', options)
  .then(response => response.json())
  .then(response => console.log(response))
  .catch(err => console.error(err));

Capture Web Screenshot

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: '{"url":"https://agent.ai","ttl_for_screenshot":86400}'
};

fetch('https://api-lr.agent.ai/v1/action/grab_web_screenshot', options)
  .then(response => response.json())
  .then(response => console.log(response))
  .catch(err => console.error(err));

Get YouTube Transcript

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: '{"url":"https://youtube.com/watch?v=example"}'
};

fetch('https://api-lr.agent.ai/v1/action/get_youtube_transcript', options)
  .then(response => response.json())
  .then(response => console.log(response))
  .catch(err => console.error(err));

Build

Docker build:

docker build -t mcp/agentai:latest .

License

This MCP server is licensed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, please see the LICENSE file in the project repository.