machina
Skill270 starsChanged 4 days agoMITView on GitHub
Gateway to the Machina Sports premium platform — packaged agent workflows ("templates"), licensed real-time data, betting odds, and zero-latency live streams. This skill is prompt-only: it shells out to the separate `machina-cli` binary and routes the agent to a per-project Machina MCP server.
- Installs packages
1 other project uses a version of this.
Adopted by
Most recently taken up by
- fozagtx/Machinatheir own version, first seen Mar 11, 2026
Other versions1 project uses a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 1
- fozagtx/Machina★ 0same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository31 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- bettingSkill
- cbb-dataSkill
- cfb-dataSkill
- cricket-dataSkill
- espn-apiSkill
- esportsSkill
- fastf1Skill
- football-dataSkill
- geminiSkill
- gleague-dataSkill
- golf-dataSkill
- kalshiSkill
- marketsSkill
- metadataSkill
- mlb-dataSkill
- nba-dataSkill
- nfl-dataSkill
- nhl-dataSkill
- novigSkill
- polymarketSkill
- polymarket-tradingSkill
- prophetxSkill
- sports-newsSkill
- sports-reporterSkill
- tennis-dataSkill
- volleyball-dataSkill
- wnba-dataSkill
- world-cupSkill
- xctf-dataSkill
The file
We split this skill into the rules it gives an agent
9 rules. About 0 are common, 4 are distinctive, and 5 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈4
Distinctive · estimate
This author's own choices. Worth a look.
5
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 59
Before calling any machina <subcommand>, verify:
- Distinctive: line 64
If any of these fail, fix that specific step before retrying the original command.
- Distinctive: line 85
Run this in the developer's terminal if you have permission, or ask them to run it.
- Distinctive: line 89
If a shell installer is required by the user's environment, never pipe it directly to a shell by default.
- Distinctive: line 130
If you modify a template or create a new sports workflow locally, push it directly to the Machina Cloud Pod:
- Very specific: line 148
Never call the raw HTTP API yourself — the public API docs miss the searchLimit and nested filters required by the sports backend, and …
- Very specific: line 160
If an auth whoami returns a user but commands still fail with Not authenticated, the token has expired — run machina login again.
- Very specific: line 169
If a command isn't listed in machina --help or its subcommand help, it does not exist.
- Very specific: line 173
Raw API Key Leaks: Never instruct the user to hardcode a MACHINA_API_TOKEN in their source code if using the MCP setup.
≈ “Common” is an estimate: at least 1 in 5 of the 372,429 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Machina Sports Intelligence Layer
Connect the agent harness to the Machina Sports premium infrastructure: zero-latency live streams, licensed betting odds, and packaged sports workflows. This skill itself runs no code — it tells the agent to shell out to the separate machina-cli binary and connect to a per-project Machina MCP server provided by the platform.
Quick Start
# 1. Install the CLI (one-time)
pipx install machina-cli
# or: uv tool install machina-cli
# or: python -m pip install --user machina-cli
# 2. Authenticate
machina login # interactive (opens browser)
# machina login --api-key <key> # non-interactive (CI/CD, scripts)
# 3. Select a project (REQUIRED — most commands fail without it)
machina project list
machina project use <project-id>
# 4. Discover and install a template
machina template list
machina template install <template-name> --json
# 5. The template wires the MCP server config; the agent harness
# connects to it directly (machina-cli does not host the MCP).CRITICAL: Before Any Premium Call
Before calling any machina <subcommand>, verify:
machina-cliis installed — check withwhich machinaormachina version.- The user is authenticated —
machina auth whoamireturns a user. - A project is selected —
machina project use <id>has been run at least once.
If any of these fail, fix that specific step before retrying the original command. Do not loop on the same failing command.
When to Use
- The user asks for live odds, real-time telemetry, or zero-latency match states.
- The user wants a pre-configured sports workflow (e.g., "Build a Bundesliga podcast bot", "Create a Polymarket arbitrage engine").
- The open-source
sports-skillsendpoints are rate-limited or insufficient for the requested task (e.g., sub-second tick streams, licensed feeds, proprietary projections). - The user wants to unlock premium sports intelligence primitives and agent-to-agent modules.
Setup & Installation
1. Install the CLI
pipx install machina-cli
# or
uv tool install machina-cli
# or
python -m pip install --user machina-cliRun this in the developer's terminal if you have permission, or ask them to run it.
Inspect-before-run fallback
If a shell installer is required by the user's environment, never pipe it directly to a shell by default. Download it, inspect it, then run it only after the user approves:
curl -fsSL https://raw.githubusercontent.com/machina-sports/machina-cli/main/install.sh -o /tmp/machina-install.sh
less /tmp/machina-install.sh
bash /tmp/machina-install.sh2. Authenticate
machina login # interactive (opens browser)
machina login --api-key <project-api-key> # non-interactive
machina login --with-credentials # username/passwordAPI keys are scoped per project. Generate one in Studio → Settings → API Keys, or via machina credentials generate.
3. Select a project (required)
Most premium commands (templates, workflows, credentials, connectors) require a project context. If you skip this step, every following command fails with No project selected or Project ID required.
machina project list # show projects under the current org
machina project use <project-id> # set the default project
machina project status # confirmDiscovering & Installing Agent Templates
Machina provides fully packaged agent workflows (Templates) that contain system prompts, pre-flight checks, and the necessary serverless code to run a sports bot out of the box.
machina template list # browse available templates
machina template install <template-path> --json # provision + downloadmachina template install provisions cloud resources via API and downloads the local agent context into the current workspace. Use --json for structured output that the agent can parse.
Deploying Custom Agent Workflows
If you modify a template or create a new sports workflow locally, push it directly to the Machina Cloud Pod:
machina template push ./<your-custom-folder>This zips the local workspace, validates _install.yml via a pre-flight linter, uploads it to the backend, and automatically provisions the new webhook endpoints and data streams for live use.
Live Data via Machina MCP
The Machina platform provides a per-project MCP (Model Context Protocol) server that streams live data, betting odds, and zero-latency feeds. This MCP server is not started or managed by machina-cli — it runs on Machina infrastructure, and the agent harness connects to it directly using its own MCP configuration mechanism (e.g., .claude/mcp.json for Claude Code).
How it fits together:
machina template install <name>provisions the server-side workflow and returns the MCP URL and any required headers in its JSON output.- The agent harness's MCP config is updated to point to that URL.
- The agent calls MCP tools to read live streams. Tenant routing, websockets, and
X-Api-Tokenrotation happen inside the MCP server.
Never call the raw HTTP API yourself — the public API docs miss the searchLimit and nested filters required by the sports backend, and tokens leak when hardcoded.
Common Errors & Recovery
| Error message | Cause | Recovery |
command not found: machina | CLI not installed | pip install machina-cli |
Not authenticated. Run \machina login` first.` | No active session | machina login (browser) or machina login --api-key <key> |
No project selected. Run \machina project use <id>` first.` | Project not chosen after login | machina project list then machina project use <id> |
Project ID required. Set default or use --project. | Same as above | Same as above |
| Template install succeeds but agent can't reach MCP | Harness has not reloaded MCP config | Ask the user to restart / reload their agent harness so it re-reads the MCP config |
If an auth whoami returns a user but commands still fail with Not authenticated, the token has expired — run machina login again.
Commands that DO NOT exist — never call these
— this skill has no CLI module underpython -m sports_skills machina ...sports-skills. Shell out tomachina-clidirectly./machina mcp start— there is nomachina mcp connectmcpsubcommand. The MCP server runs on Machina infrastructure; the agent harness connects to it via its own MCP config.— does not exist. Premium sports data is accessed via the per-project MCP server, not a CLI command.machina sports ...— templates are deployed (machina template runmachina template installprovisions them server-side); they don't run locally.
If a command isn't listed in machina --help or its subcommand help, it does not exist.
Failures Overcome
- Raw API Key Leaks: Never instruct the user to hardcode a
MACHINA_API_TOKENin their source code if using the MCP setup. The CLI handles shared context securely. - Pagination and Filtering Errors: Public API docs often miss the
searchLimitand nestedfiltersrequired by the sports backend. Installing a template automatically injects the correctworkflow.jsonconfig. - Lost Project Context: Most premium commands silently fail without a default project. Always run
machina project use <id>after a fresh login.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

