ARC MCP Server

Agent Referral Chain — Legal MCP tool service with referral commissions for AI Agents.

⚠️ This is a legal SaaS referral program, NOT a Ponzi/fund scheme. All earnings come from real API service fees.

What It Does

ARC provides paid Chinese astrology API tools that AI Agents can:

• Use — Ziwei Doushu charting, Bazi analysis (real value)
• Refer — Get a referral code, share with other Agents
• Earn — 10%/5%/3% commission from referred Agents' API usage

How It's Legal

Illegal Ponzi	ARC (Legal)
Returns come from new investors	Returns come from service fees
No real product	Real API tools with market value
Promises fixed returns	No promises, usage-based commission
Collapses when growth stops	Sustainable — revenue from real usage

MCP Tools

Tool	Price	Description
arc_register	Free	Register, get invite code + 3 free calls
arc_pricing	Free	List all services and prices
arc_balance	Free	Check commission earnings
arc_invite_code	Free	Get your referral code
arc_team_stats	Free	View team size and commission
arc_withdraw	Free	Withdraw commissions (min $1)
arc_call_log	Free	View recent API calls
arc_platform_stats	Free	Public platform statistics
ziwei_chart	$0.005	Ziwei Doushu (Purple Star) chart
bazi_chart	$0.003	Bazi (Four Pillars) chart

Quick Start

As MCP Server (stdio)

pip install mcp lunarcalendar
python server.py

Configure in Claude Desktop

{
  "mcpServers": {
    "arc": {
      "command": "python",
      "args": ["/path/to/server.py"]
    }
  }
}

Example: Register & Use

1. arc_register(agent_id="your-wallet-address")
   → Get invite code "ABC123" + 3 free calls

2. ziwei_chart(year=1990, month=6, day=15, hour=14, agent_id="your-wallet-address")
   → Get chart result, 1 free call used

3. arc_invite_code(agent_id="your-wallet-address")
   → Share code "ABC123" with other Agents

4. When they use the service, you earn 10% commission automatically

Referral Commission Structure

Agent C calls ziwei_chart ($0.005)
  → 82% Platform ($0.0041)
  → 10% Direct referrer Agent B ($0.0005)
  → 5%  2nd level Agent A ($0.00025)
  → 3%  3rd level ($0.00015)

• 3-level only (legal in most jurisdictions)
• Commission comes from platform revenue, NOT from the referral's payment
• Minimum withdrawal: $1.00 USDC on Base network

API Endpoint (HTTP)

Production: http://152.136.182.66:8898

Tech Stack

• Python 3.8+
• SQLite (lightweight, no external DB needed)
• MCP stdio protocol
• Ziwei Doushu engine (14 main stars + auxiliary stars + Four Transformations)
• Bazi engine (Four Pillars with lunar calendar conversion)

License

MIT