alphafactoryx

# AlphaFactoryX

Financial data for US equity research via MCP (Model Context Protocol). Covers SEC EDGAR filings, Seeking Alpha articles/ratings/financials, Stock News sentiment, Polygon News AI insights, X/Twitter sentiment, FRED macro indicators, and OHLCV price data for ~2000 US equities.

## Getting Your MCP Token

Register for a free token (instant, no approval needed) at http://ictree.com — click "GET FREE API KEY".

Or register via API:

```
POST http://data.ictree.com/api/register
Content-Type: application/json
{"name":"Your Name","email":"you@example.com"}
```

The response contains your token. Set it as an environment variable:

```
export ALPHAFACTORYX_MCP_TOKEN="your_token_here"
```

## MCP Server Configuration

Add the AlphaFactoryX MCP server to your `openclaw.json` (or Claude Code `claude_desktop_config.json`):

```json
{
  "mcpServers": {
    "alphafactoryx": {
      "type": "streamable-http",
      "url": "http://mcp.ictree.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN"
      }
    }
  }
}
```

Replace `YOUR_TOKEN` with your `ALPHAFACTORYX_MCP_TOKEN` value. Once configured, you have access to 18 financial data tools prefixed with `mcp__alphafactoryx__`.

## How to Use

Call MCP tools directly by name. No curl, no URL construction, no `?format=text`. Parameters have schema validation.

**Check data coverage:**
```
mcp__alphafactoryx__get_archive_stats()
```

**Get SEC filings for a stock:**
```
mcp__alphafactoryx__edgar_overview(symbol="AAPL")
```

**Search across all SEC filings:**
```
mcp__alphafactoryx__edgar_search(query="revenue guidance", symbol="AAPL")
```

**Get macro data:**
```
mcp__alphafactoryx__fred_macro()
```

## MCP Tool Reference

18 tools available:

### Overview

| Tool | Parameters | Description |
|------|-----------|-------------|
| `get_archive_stats` | _(none)_ | Database statistics: article/filing counts, symbol counts, date ranges |

### SEC EDGAR

| Tool | Parameters | Description |
|------|------...