caiovicentino
diff --git a/‎.codecov.yml‎
Lines changed: 37 additions & 0 deletions b/‎.codecov.yml‎
Lines changed: 37 additions & 0 deletions
diff --git a/‎.dockerignore‎
Lines changed: 89 additions & 0 deletions b/‎.dockerignore‎
Lines changed: 89 additions & 0 deletions
diff --git a/‎.env.example‎
Lines changed: 66 additions & 5 deletions b/‎.env.example‎
Lines changed: 66 additions & 5 deletions
diff --git a/‎.github/FUNDING.yml‎
Lines changed: 14 additions & 0 deletions b/‎.github/FUNDING.yml‎
Lines changed: 14 additions & 0 deletions
@@ -0,0 +1,37 @@
+# Codecov configuration for Polymarket MCP Server
+
+coverage:
+  precision: 2
+  round: down
+  range: "80...100"
+
+  status:
+    project:
+      default:
+        target: 80%
+        threshold: 2%
+        if_ci_failed: error
+
+    patch:
+      default:
+        target: 80%
+        threshold: 5%
+
+  ignore:
+    - "tests/"
+    - "**/__pycache__/"
+    - "**/venv/"
+    - "**/site-packages/"
+
+comment:
+  layout: "header, diff, flags, files"
+  behavior: default
+  require_changes: false
+  require_base: false
+  require_head: true
+
+flags:
+  unittests:
+    paths:
+      - src/
+    carryforward: true
@@ -0,0 +1,89 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+pip-wheel-metadata/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# Virtual environments
+venv/
+env/
+ENV/
+env.bak/
+venv.bak/
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+.tox/
+.nox/
+coverage.xml
+*.cover
+.hypothesis/
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+.DS_Store
+
+# Git
+.git/
+.gitignore
+.gitattributes
+
+# CI/CD
+.github/
+.gitlab-ci.yml
+
+# Environment
+.env
+.env.local
+.env.production
+*.env
+
+# Logs
+*.log
+logs/
+
+# Documentation (except README)
+docs/
+*.md
+!README.md
+
+# Docker
+.dockerignore
+Dockerfile*
+docker-compose*.yml
+
+# Kubernetes
+k8s/
+*.yaml
+!pyproject.toml
+
+# Misc
+tmp/
+temp/
+.cache/
+node_modules/
@@ -1,45 +1,106 @@
-# Polygon Wallet Configuration (REQUIRED)
+# Polymarket MCP Server Configuration
+# Copy this file to .env and fill in your values
+
+# ============================================================================
+# DEMO MODE - Run without real wallet credentials (read-only)
+# ============================================================================
+# Set to true for read-only access without needing a wallet
+# Perfect for testing market discovery, analysis, and monitoring features
+# Trading functions will be disabled in DEMO mode
+#
+# When DEMO_MODE=true, you don't need to provide:
+#   - POLYGON_PRIVATE_KEY
+#   - POLYGON_ADDRESS
+#
+# The system will use safe demo values automatically.
+DEMO_MODE=false
+
+# ============================================================================
+# Polygon Wallet Configuration (REQUIRED unless DEMO_MODE=true)
+# ============================================================================
+
 # Your Polygon wallet private key (without 0x prefix)
+# Get from: MetaMask > Settings > Security > Export Private Key
+# IMPORTANT: Keep this secret! Never commit to git or share publicly
 POLYGON_PRIVATE_KEY=your_private_key_here
-# Your Polygon wallet address
+
+# Your Polygon wallet address (with 0x prefix)
+# Get from: Your wallet's public address
 POLYGON_ADDRESS=0xYourAddressHere
+
 # Polygon chain ID (137 for mainnet, 80002 for Amoy testnet)
 POLYMARKET_CHAIN_ID=137
 
-# Polymarket API Credentials (OPTIONAL - will be auto-created if not provided)
+# ============================================================================
+# Polymarket API Credentials (OPTIONAL - auto-created if not provided)
+# ============================================================================
+
 # L2 API key for authenticated requests
+# Leave empty to auto-generate on first run
+# Or get from: https://polymarket.com/settings/api
 POLYMARKET_API_KEY=
-# API key passphrase
 POLYMARKET_PASSPHRASE=
-# API key name/identifier
 POLYMARKET_API_KEY_NAME=
 
+# ============================================================================
 # Safety Limits - Risk Management
+# ============================================================================
+
 # Maximum size for a single order in USD
 MAX_ORDER_SIZE_USD=1000
+
 # Maximum total exposure across all positions in USD
 MAX_TOTAL_EXPOSURE_USD=5000
+
 # Maximum position size per market in USD
 MAX_POSITION_SIZE_PER_MARKET=2000
+
 # Minimum liquidity required in market before trading (USD)
 MIN_LIQUIDITY_REQUIRED=10000
+
 # Maximum spread tolerance (0.05 = 5%)
 MAX_SPREAD_TOLERANCE=0.05
 
+# ============================================================================
 # Trading Controls
+# ============================================================================
+
 # Enable autonomous trading without confirmation
+# WARNING: Use with caution! Set to false for manual approval
 ENABLE_AUTONOMOUS_TRADING=true
+
 # Require user confirmation for orders above this USD amount
 REQUIRE_CONFIRMATION_ABOVE_USD=500
+
 # Automatically cancel orders if spread exceeds MAX_SPREAD_TOLERANCE
 AUTO_CANCEL_ON_LARGE_SPREAD=true
 
+# ============================================================================
 # API Endpoints (OPTIONAL - uses defaults if not set)
+# ============================================================================
+
 # Polymarket CLOB API endpoint
 CLOB_API_URL=https://clob.polymarket.com
+
 # Gamma API endpoint for market data
 GAMMA_API_URL=https://gamma-api.polymarket.com
 
+# ============================================================================
 # Logging
+# ============================================================================
+
 # Log level: DEBUG, INFO, WARNING, ERROR
 LOG_LEVEL=INFO
+
+# ============================================================================
+# Advanced Configuration (typically no changes needed)
+# ============================================================================
+
+# USDC token address on Polygon
+USDC_ADDRESS=0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174
+
+# CTF Exchange contract address
+CTF_EXCHANGE_ADDRESS=0x4bFb41d5B3570DeFd03C39a9A4D8dE6Bd8B8982E
+
+# Conditional Token contract address
+CONDITIONAL_TOKEN_ADDRESS=0x4D97DCd97eC945f40cF65F87097ACe5EA0476045
@@ -0,0 +1,14 @@
+# GitHub Sponsors configuration
+# These are supported funding model platforms
+
+github: # Replace with up to 4 GitHub Sponsors-enabled usernames e.g., [user1, user2]
+patreon: # Replace with a single Patreon username
+open_collective: # Replace with a single Open Collective username
+ko_fi: # Replace with a single Ko-fi username
+tidelift: # Replace with a single Tidelift platform-name/package-name e.g., npm/babel
+community_bridge: # Replace with a single Community Bridge project-name e.g., cloud-foundry
+liberapay: # Replace with a single Liberapay username
+issuehunt: # Replace with a single IssueHunt username
+otechie: # Replace with a single Otechie username
+lfx_crowdfunding: # Replace with a single LFX Crowdfunding project-name e.g., cloud-foundry
+custom: # Replace with up to 4 custom sponsorship URLs e.g., ['link1', 'link2']