> ## Agent Instructions
>
> Base URL: https://api.anysite.io
> Authentication: send the `access-token` header. Do NOT use `Authorization: Bearer`.
> Full endpoint catalog: https://app.anysite.io/docs
# MCP Server Installation

Install and configure the Anysite MCP Server

## Overview

The Anysite MCP (Model Context Protocol) Server provides AI tools with direct access to LinkedIn, Instagram, Reddit, and other social media data extraction capabilities.

## Prerequisites

- Python 3.8 or higher
- Anysite API account and credentials
- Compatible AI client (Claude Desktop, Cursor, Windsurf)

## Installation

  
#### Clone Repository

    ```bash
    git clone https://github.com/horizondatawave/hdw-mcp-server.git
    cd hdw-mcp-server
    ```
  
  
  
#### Get API Credentials

    1. Visit [anysite.io](https://app.anysite.io/register)
    2. Create your account and log in
    3. Navigate to account settings
    4. Generate your API credentials:
       - `HDW_ACCESS_TOKEN`: Your API access token
       - `HDW_ACCOUNT_ID`: Your account identifier (optional)
  
  
  
#### Configure Environment

    Create a `.env` file or set environment variables:
    ```bash
    export HDW_ACCESS_TOKEN="your_access_token_here"
    export HDW_ACCOUNT_ID="your_account_id_here"
    ```
  

## Client Configuration

### Claude Desktop

Add this configuration to your Claude Desktop config file:

  
#### macOS

    Edit `~/Library/Application Support/Claude/claude_desktop_config.json`:
    
    ```json
    {
      "mcpServers": {
        "hdw-mcp-server": {
          "command": "python",
          "args": ["/path/to/hdw-mcp-server/main.py"],
          "env": {
            "HDW_ACCESS_TOKEN": "your_access_token_here",
            "HDW_ACCOUNT_ID": "your_account_id_here"
          }
        }
      }
    }
    ```
  
  
  
#### Windows

    Edit `%APPDATA%\Claude\claude_desktop_config.json`:
    
    ```json
    {
      "mcpServers": {
        "hdw-mcp-server": {
          "command": "python",
          "args": ["C:\\path\\to\\hdw-mcp-server\\main.py"],
          "env": {
            "HDW_ACCESS_TOKEN": "your_access_token_here",
            "HDW_ACCOUNT_ID": "your_account_id_here"
          }
        }
      }
    }
    ```
  

### Cursor

Add to your Cursor settings:

```json
{
  "mcp.servers": {
    "hdw-mcp-server": {
      "command": "python",
      "args": ["/path/to/hdw-mcp-server/main.py"],
      "env": {
        "HDW_ACCESS_TOKEN": "your_access_token_here",
        "HDW_ACCOUNT_ID": "your_account_id_here"
      }
    }
  }
}
```

### Windsurf

Configure in your Windsurf settings:

```json
{
  "mcpServers": {
    "hdw-mcp-server": {
      "command": "python",
      "args": ["/path/to/hdw-mcp-server/main.py"],
      "env": {
        "HDW_ACCESS_TOKEN": "your_access_token_here",
        "HDW_ACCOUNT_ID": "your_account_id_here"
      }
    }
  }
}
```

## Verification

After installation, restart your AI client and verify the MCP server is working:

1. Open a new conversation in your AI client
2. Ask: "What MCP tools do you have available?"
3. You should see Anysite tools listed

> 
Make sure to replace `/path/to/hdw-mcp-server/` with the actual path where you cloned the repository.

## Troubleshooting

  
#### MCP server not appearing in AI client

    - Check that the file path in your configuration is correct
    - Verify that Python is accessible from the command line
    - Ensure your credentials are properly set in the environment variables
    - Restart your AI client after making configuration changes
  
  
  
#### Authentication errors

    - Verify your `HDW_ACCESS_TOKEN` and `HDW_ACCOUNT_ID` are correct
    - Check that your Anysite account is active
    - Ensure you have API access permissions
  
  
  
#### Python path issues

    - Use the full path to your Python executable
    - If using a virtual environment, use the Python path from that environment
    - On Windows, use forward slashes or double backslashes in paths
  

## Next Steps

- [Configure the MCP Server](/docs/mcp-server/local-server/configuration)
- [Explore Available Tools](/docs/mcp-server/tools)
- [View Usage Examples](/docs/mcp-server/local-server/examples)