MCP, MCP server
Oracle3 Prediction Market Agent
Oracle3: open-source trading engine and MCP server for prediction markets.
Compatibility: Not stated.
Grade B
Minor issues only, no Medium or High. Worth a quick look at the findings below before installing.
Not a guarantee. A hygiene check of the source at the commit shown, not a security audit.
Rescanned at commit 267fb7c48dae, unchanged since the check below.
NETWORK_NO_FIXED_HOST SECRETS_PATH_DOTENV PERMISSION_SHELL_DECLARED SECRETS_ENV_READ OBFUSCATION_FILE_OVER_READ_CAP
Why this grade
- NETWORK_NO_FIXED_HOST Low
Makes a network call whose host is not written as a fixed address.
oracle3/data/base_fetcher.py, line 143
async def fetch(self, *args: Any, **kwargs: Any) -> Any: - SECRETS_PATH_DOTENV Low
Mentions a .env file.
.github/SECURITY.md, line 28
- **Never commit private keys** or `.env` files to version control - PERMISSION_SHELL_DECLARED Note
Runs shell commands, and the manifest or description says so.
oracle3/cli/cli.py, line 47
command = self.commands.get(name) - SECRETS_ENV_READ Note
Reads an environment variable whose name contains KEY, SECRET, TOKEN, PASSWORD or CREDENTIAL.
oracle3/cli/agent_commands.py, line 939
private_key = wallet_private_key or os.environ.get('POLYMARKET_PRIVATE_KEY') - OBFUSCATION_FILE_OVER_READ_CAP Note
A file was over the read cap and was not fully read.
poetry.lock, line 1
# This file is automatically @generated by Poetry 2.3.2 and should not be changed by hand.
Any High, or two or more Medium findings, give D. One Medium gives C. Low findings or a security Note give B. Each code names a finding behind the letter.
Grades are a hygiene check of the source at the commit shown, on the date checked, not a security audit or a guarantee. The free directory grades are automated. Before release, a PlugVet engineer reviews every paid report and any grade we hold back, including all F grades, against the source code and the evidence we quote.
What was checked
Plain notes from the hygiene checks.
Permissions
Note
requests shell access. The manifest names this permission.
PERMISSION_SHELL_DECLARED
oracle3/cli/cli.py, line 47
command = self.commands.get(name)
scripts/check_agent_contracts.py, line 350
revision = subprocess.run(
scripts/check_agent_contracts.py, line 359
subprocess.run(
Show more
scripts/replay_runtime_regressions.py, line 153
result = subprocess.run(
scripts/replay_runtime_regressions.py, line 168
return subprocess.check_output(['git', *arguments], cwd=repo, timeout=30)
Install and update
Pass
No install-time script found, and dependencies are pinned or absent.
Network
Concern
can reach a host that is not written as a fixed address.
NETWORK_NO_FIXED_HOST
oracle3/data/base_fetcher.py, line 143
async def fetch(self, *args: Any, **kwargs: Any) -> Any:
oracle3/data/live/google_news_data_source.py, line 98
return requests.get(
oracle3/data/live/live_data_source.py, line 113
"""Synchronous order book fetch (runs in thread pool)."""
Show more
oracle3/data/live/polymarket_orderflow.py, line 471
async def fetch(self, tickers: list[PolyMarketTicker]) -> list[OrderFlowSignal]: # type: ignore[override]
oracle3/data/live/twitter_fetcher.py, line 374
async def fetch(
oracle3/trader/kalshi_trader.py, line 137
def fetch() -> dict[str, Any]:
scripts/crawl_cross_platform_data.py, line 92
resp = requests.get(
scripts/crawl_cross_platform_data.py, line 160
resp = requests.get(
Secrets
Concern
reads a credential or environment file.
SECRETS_ENV_READ SECRETS_PATH_DOTENV
oracle3/cli/agent_commands.py, line 939
private_key = wallet_private_key or os.environ.get('POLYMARKET_PRIVATE_KEY')
oracle3/cli/agent_commands.py, line 985
keypair = solana_keypair_path or os.environ.get('SOLANA_KEYPAIR_PATH')
.github/SECURITY.md, line 28
- **Never commit private keys** or `.env` files to version control
Show more
oracle3/cli/news_commands.py, line 214
token = api_token or os.environ.get('THENEWSAPI_TOKEN', '')
oracle3/data/live/coingecko_x402_data_source.py, line 53
self._wallet_key: str | None = os.environ.get('COINGECKO_X402_WALLET_KEY')
oracle3/data/live/kalshi_data_source.py, line 66
key_id = api_key_id or os.environ.get('KALSHI_API_KEY_ID')
oracle3/data/live/kalshi_data_source.py, line 67
pk_path = private_key_path or os.environ.get('KALSHI_PRIVATE_KEY_PATH')
oracle3/data/live/twitter_fetcher.py, line 78
self.bearer_token = bearer_token or os.environ.get('X_BEARER_TOKEN')
oracle3/live/live_trader.py, line 529
'kalshi', api_key_id or os.environ.get('KALSHI_API_KEY_ID') or '', state_store
.gitignore, line 122
# Environments
poetry.lock, line 3836
description = "Read key-value pairs from a .env file and set them as environment variables"
Agent instructions
Pass
No instruction to ignore earlier instructions or to hide a step.
Obfuscation
Note
a file was over the read cap and was not fully read.
OBFUSCATION_FILE_OVER_READ_CAP
poetry.lock, line 1
# This file is automatically @generated by Poetry 2.3.2 and should not be changed by hand.
Licence
Pass
A licence file is present (LICENSE).
Maintainer activity
Pass
The latest commit is within the last 365 days.
Note
Hygiene check of commit 267fb7c48dae. requests shell access. The manifest names this permission. can reach a host that is not written as a fixed address. reads a credential or environment file. a file was over the read cap and was not fully read.
Date and source
Date checked:
github.com
Commit graded: 267fb7c48dae7c4ff8922c02a3a223443e51bf0b
This link goes to the original host. PlugVet does not host or check what you download from there, and installing it is your own decision and risk.