AgentKit — MCP Server for Business Intelligence Agents

Expose enterprise KPIs, health scores, forecasting, and anomaly detection as tools, resources, and prompt templates that any MCP-compatible agent (Claude Desktop, Cursor, LangGraph, Claude Agent SDK, CrewAI) can use.

🔗 Live MCP server (dashboard): https://agentkit.ysiddo-ai-projects.app/ — connect from Claude Desktop via mcp-remote (see claude_desktop_config.example.json). On-demand backend (first call ~30–60 s). Self-hosting: see SELF_HOSTING.md.

What It Does

• 6 MCP Tools: query_kpis, get_company_health, detect_kpi_anomalies, forecast_metric, list_available_metrics, get_executive_summary
• 6 MCP Resources: kpi://Finance/latest and similar for Growth, Operations, People, ESG, IT_Ops
• 1 Reusable Prompt: monthly_executive_briefing
• LangGraph 3-agent workflow in workflow.py (Planner → Analyst → Reporter)
• Claude Agent SDK demo in demos/claude_agent_sdk_demo.py
• CrewAI demo in demos/crewai_demo.py
• DSPy research scaffold in research/dspy_experiment.py
• 34 tests across smoke, API, integration, and LangGraph workflow

PyPI Package

pip install agentkit-mcp   # v0.1.4
agentkit-mcp               # CLI entrypoint

Quick Start

python -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt
cp .env.example .env  # fill in keys + POSTGRES_URL
python mcp_server.py

Claude Desktop Setup

Add to ~/.config/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "agentkit": {
      "command": "python",
      "args": ["/abs/path/to/agentkit/mcp_server.py"],
      "env": {
        "POSTGRES_URL": "postgresql://...",
        "ANTHROPIC_API_KEY": "sk-ant-...",
        "GROQ_API_KEY": "gsk_...",
        "OPENAI_API_KEY": "sk-...",
        "LLM_DEFAULT": "groq/llama-3.3-70b-versatile",
        "LLM_REASONING": "anthropic/claude-sonnet-4-6",
        "LLM_JUDGE": "anthropic/claude-haiku-4-5",
        "LLM_LOCAL": "ollama/llama3.3",
        "LOG_LEVEL": "DEBUG",
        "TELEMETRY_OPT_OUT": "true"
      }
    }
  }
}

Leveraging Full Platform Capabilities

AgentKit is highly configurable. Make sure you are not underestimating its capabilities by omitting key environment variables:

• LLM Routing/Overrides: Use LLM_DEFAULT, LLM_REASONING, LLM_JUDGE, and LLM_LOCAL to precisely route distinct tasks to the most suitable models, ensuring you get the best balance of speed and cost.
• Provider Support: In addition to Anthropic and Groq, OpenAI (OPENAI_API_KEY) and Ollama are natively supported.
• Diagnostics: You can adjust LOG_LEVEL to DEBUG to gain deeper insights into the orchestration engine.
• Telemetry: The platform automatically sends anonymous telemetry, but you have the flexibility to disable it via TELEMETRY_OPT_OUT=true.

Restart Claude Desktop, then ask:

• "What's our company health right now?"
• "Forecast revenue for the next 6 months."
• "Are there anomalies in the Finance KPIs?"

LangGraph Workflow

from workflow import analyze
result = analyze("What drove gross margin in Q1?")
print(result["report"])

Architecture

        Claude Desktop / Cursor / LangGraph
                      │
                      ▼ MCP
              ┌──────────────────┐
              │  mcp_server.py   │
              │   6 tools        │
              │   6 resources    │
              │   1 prompt       │
              └────────┬─────────┘
                       │
        ┌──────────────┼──────────────┐
        ▼              ▼              ▼
   pg_store      insights      forecasting
   (KPIs)        (health,      (LinearReg
                 anomalies)    + Monte Carlo)

License

AGPL-3.0

⚖️ License & Enterprise Use (Dual-License)

This project is open-source under the AGPL-3.0 License. It is completely free for researchers, students, and open-source hobbyists.

Commercial Use: The AGPLv3 license requires that any proprietary network service (SaaS, internal corporate tools) that uses or modifies this code must also open-source its entire backend.

If you wish to use this framework in a closed-source commercial environment, or require Enterprise features (SSO, Active Directory, Custom VPC Deployment, Strict RBAC), you must obtain a Commercial License. Please reach out to discuss commercial licensing and integration consulting.

📡 Anonymous Telemetry

This project collects anonymous, GDPR-compliant startup pings to help the author understand usage volume and prioritize development.

• What is collected: A startup event timestamp and anonymized deployment origin. No API keys, no user prompts, and no sensitive application data is ever collected.
• How to disable: We respect your privacy and development environment. To opt-out, simply set TELEMETRY_OPT_OUT=true in your .env file.

Licensing

This project is licensed under the AGPL-3.0 License.

Commercial Use: If you wish to use this software commercially without releasing your own source code, please see COMMERCIAL.md to obtain a commercial license.

Telemetry: See TELEMETRY.md for our privacy-first data practices.

Claude Desktop Configuration

To use AgentKit with Claude Desktop, add the following to your claude_desktop_config.json:

{
  "mcpServers": {
    "agentkit": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e", "OPENAI_API_KEY=your_key_here",
        "ghcr.io/yacine-ai-tech/agentkit:latest"
      ]
    }
  }
}