MCP server
oxyn-mcp is a Model Context Protocol server for the Oxyn registry. Connect it to your coding agent and ask for what you need (“add an approval card to the settings page”): the agent finds the component, reads its props, and copies the code into src/oxyn/ exactly as the oxyn CLI would.
Install
Section titled “Install”The server is not on crates.io yet. Install it from the repository:
cargo install --git https://github.com/ismailqureshi72/Oxyn oxyn-mcpThat puts oxyn-mcp in ~/.cargo/bin. It speaks MCP over stdio; your agent starts it, you never run it by hand.
Connect your agent
Section titled “Connect your agent”Each agent starts oxyn-mcp itself once it knows the command: oxyn-mcp, with no arguments. Pick yours.
Claude Code
Section titled “Claude Code”claude mcp add --transport stdio oxyn -- oxyn-mcpAdd --scope project to share it with your team through .mcp.json, or --scope user for every project.
OpenAI Codex
Section titled “OpenAI Codex”codex mcp add oxyn -- oxyn-mcpOr add it to ~/.codex/config.toml (or .codex/config.toml in a trusted project). The Codex CLI, the IDE extension and the ChatGPT desktop app share this file.
[mcp_servers.oxyn]command = "oxyn-mcp"
Cursor
Section titled “Cursor”.cursor/mcp.json in your project, or ~/.cursor/mcp.json for every project:
{ "mcpServers": { "oxyn": { "type": "stdio", "command": "oxyn-mcp" } }}
Windsurf
Section titled “Windsurf”Windsurf is now Devin Desktop. Add the server to ~/.config/devin/mcp_config.json (on Windows %APPDATA%\devin\mcp_config.json), or to .devin/mcp_config.json in your project. Older Windsurf builds read ~/.codeium/windsurf/mcp_config.json; the editor’s Open MCP config file action opens the right one.
{ "mcpServers": { "oxyn": { "command": "oxyn-mcp", "args": [] } }}
VS Code (GitHub Copilot)
Section titled “VS Code (GitHub Copilot)”Run MCP: Add Server, choose Command (stdio) and enter oxyn-mcp, or write the file yourself: .mcp.json at the workspace root to share it, or ~/.copilot/mcp-config.json for all your workspaces.
{ "mcpServers": { "oxyn": { "type": "stdio", "command": "oxyn-mcp", "args": [], "tools": ["*"] } }}Settings → AI → MCP Servers → Add Local Server, or in your settings file (zed: open settings file):
{ "context_servers": { "oxyn": { "command": "oxyn-mcp", "args": [], "env": {} } }}
Google Antigravity
Section titled “Google Antigravity”In the app, open Customizations → Installed → MCP Servers and copy the config file path; in the IDE, MCP Servers → Manage MCP Servers → View raw config. The file is ~/.gemini/config/mcp_config.json, or .agents/mcp_config.json in a workspace. Antigravity CLI reads the same files (/mcp shows the status).
{ "mcpServers": { "oxyn": { "command": "oxyn-mcp" } }}
Gemini CLI
Section titled “Gemini CLI”gemini mcp add oxyn oxyn-mcpThat writes .gemini/settings.json in the project; add --scope user for ~/.gemini/settings.json. The same entry by hand:
{ "mcpServers": { "oxyn": { "command": "oxyn-mcp" } }}
Kimi Code
Section titled “Kimi Code”Run /mcp-config in Kimi Code CLI, or add the server to ~/.kimi-code/mcp.json (every project) or .kimi-code/mcp.json (this repository). /mcp shows the connection.
{ "mcpServers": { "oxyn": { "command": "oxyn-mcp" } }}
MiniMax Code
Section titled “MiniMax Code”Open the plugin manager, switch to MCP Servers and add it in JSON mode, or edit ~/.minimax/mcp.json. Check it with mcode mcp list --human.
{ "mcpServers": { "oxyn": { "type": "stdio", "command": "oxyn-mcp", "enabled": true } }}cline mcp add oxyn --yes -- oxyn-mcpIn the editor extensions: MCP Servers → Configure → Configure MCP Servers, then add the entry under mcpServers (the CLI keeps it in ~/.cline/data/settings/cline_mcp_settings.json):
{ "mcpServers": { "oxyn": { "command": "oxyn-mcp", "args": [], "disabled": false } }}
OpenCode
Section titled “OpenCode”opencode mcp add oxyn -- oxyn-mcpAdd --global for every project. By hand, in opencode.jsonc:
{ "mcp": { "servers": { "oxyn": { "type": "local", "command": ["oxyn-mcp"] } } }}Other clients
Section titled “Other clients”Any MCP client that can start a local (stdio) server works: the command is oxyn-mcp, with no arguments.
list_components: every item, free and Pro, filtered bycategory,tierorframework.search_components: searches names, categories and descriptions.get_component: one item. What it is, its props (Dioxus) or builder methods (GPUI), the items and crates it needs, the install command, its docs page, and the source files (for a Pro item only when the agent passesinclude_code: true, since that counts toward the month’s Pro items).add_component: copies items and what they need into a project, adds crates toCargo.tomland declaresmod oxyn;. Sets the project up on first use.get_install_instructions: setup steps for Dioxus or GPUI: dependencies, styles and theme.
add_component takes project_path (the folder with your Cargo.toml); without it, it uses the folder the agent started the server in. Files you changed since they were added are kept unless the agent passes overwrite, the same protection oxyn add gives you.
Free and Pro
Section titled “Free and Pro”74 components are free (MIT) and install directly. Pro items install with an Oxyn Pro or Team plan: the server uses the same sign-in as the CLI, so run oxyn login once on that computer, or give the server a token from your account page as OXYN_TOKEN in its environment, for example:
claude mcp add oxyn --env OXYN_TOKEN=oxyn_… -- oxyn-mcpEach distinct Pro item counts once per billing month toward your plan’s Pro items (Pro: 20 components and 8 screens or blocks; Team: 75 and 22, shared), the same count as the CLI and the site; adding it again that month is free. When an item needs a plan, a sign-in, or this month’s items are used, get_component and add_component say so, with the count and the reset date.
Registry
Section titled “Registry”The server reads https://oxynui.com/r, the same registry as the CLI. Point it elsewhere with --registry <url-or-directory> in the command, or the OXYN_REGISTRY environment variable, for example a registry built from a checkout (site/public/r).
Prompt for your agent
Section titled “Prompt for your agent”Paste this into Claude Code, Codex, Cursor or any other coding agent to set Oxyn up in your project. The copy button is in the corner of the block.
Set up Oxyn (Rust UI components for agent apps,https://oxynui.com) in this project.
1. If the `oxyn` command is missing, install it: cargo install --git https://github.com/ismailqureshi72/Oxyn oxyn-cli If the oxyn MCP server (oxyn-mcp) is connected, you can use its tools (search_components, get_component, add_component) instead of the CLI.2. In the root of this Dioxus or GPUI project, run `oxyn init` once.3. Find components with `oxyn search <words>` or `oxyn list` (add --json to read the output) and check one with `oxyn view <slug>`.4. Add what you need with `oxyn add <slug>`. Use the `use crate::oxyn::...` lines and the stylesheet it prints, keep the src/oxyn/ module layout, and theme through data-oxyn-theme and the Oxyn token CSS variables instead of hard-coded colours.5. Treat the files in src/oxyn/ as generated: build on them from my code and do not edit them unless I ask (`oxyn diff <slug>` shows local changes).6. Pro items need an Oxyn Pro plan. If `oxyn add` says an item is Pro, stop and ask me to run `oxyn login`; do not work around it.
When you are done, tell me what you installed and where.