jsoprych/elko-market-mcp repository overview

docker pull jsoprych/elko-market-mcp:latest

docker run -d \
  --name elko-market \
  -p 8082:8082 \
  -v elko-market-data:/data \
  jsoprych/elko-market-mcp:latest

docker run -d \
  --name elko-market \
  -p 8082:8082 \
  -v elko-market-data:/data \
  -e FRED_API_KEY=your_fred_key \
  -e SEC_USER_AGENT="YourName [email protected]" \
  -e BLS_API_KEY=your_bls_key \
  jsoprych/elko-market-mcp:latest

docker stop elko-market                          # stop
docker start elko-market                         # restart
docker rm elko-market                            # remove container (data volume kept)
docker rm elko-market && docker volume rm elko-market-data  # full removal (container + data)

curl -s localhost:8082/mcp.json > .mcp.json

services:
  elko-market:
    image: ghcr.io/jsoprych/elko-market-mcp:latest
    ports:
      - "8082:8082"
    volumes:
      - elko-market-data:/data
    restart: unless-stopped
    # Optional — keys can also be set from the dashboard after first run
    environment:
      - FRED_API_KEY=your_key

volumes:
  elko-market-data:

# Override
docker run -e ELKO_EASY_KEY=your_key ...

# Disable rate limiting entirely
docker run -e ELKO_EASY_KEY="" ...

curl -s localhost:8082/mcp.json > .mcp.json

{
  "mcpServers": {
    "elko-market": {
      "command": "docker",
      "args": ["run", "--rm", "-i",
               "-v", "elko-market-data:/data",
               "jsoprych/elko-market-mcp:latest",
               "mcp"]

    }
  }
}

import requests

r = requests.post("http://localhost:8082/mcp", json={
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
        "name": "yahoo_quote",
        "arguments": {"symbol": "AAPL"}
    }
})
print(r.json())

# curl equivalent
curl -s -X POST http://localhost:8082/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"yahoo_quote","arguments":{"symbol":"AAPL"}}}'

# Create a procedure
curl -s -X POST http://localhost:8082/v1/procedures \
  -H "Content-Type: application/json" \
  -d '{
    "name": "my_query",
    "description": "Recent call log for a tool",
    "sql": "SELECT datetime(ts, '\''unixepoch'\'') as time, duration_ms FROM call_log WHERE tool = '\''{{tool}}'\'' ORDER BY ts DESC LIMIT {{limit}}",
    "parameters": [
      {"name": "tool",  "type": "string",  "description": "Tool name", "required": true},
      {"name": "limit", "type": "integer", "description": "Max rows",  "required": false, "default": 10}
    ]
  }'

# Named volume (recommended)
docker run -v elko-market-data:/data ...

# Host path
docker run -v /path/on/host:/data ...