---
title: "Oh My Sol vs the Solana Developer MCP and solana-dev skill · Barestate"
description: "What the Solana Developer MCP and the Solana Foundation's solana-dev skill give a coding agent, what Oh My Sol adds on top, and how the two fit together."
url: https://barestate.xyz/compare/oh-my-sol-vs-solana-developer-mcp
---

# Oh My Sol vs the Solana Developer MCP and solana-dev skill

Short answer

The Solana Developer MCP and the solana-dev skill give a coding agent Solana documentation and patterns. Oh My Sol is a full Solana harness that already uses both: it calls the official MCP server and carries a reference pack built from the skill. On top, it adds a local Surfpool chain, a check that closes a task only when your requirements pass, error decoding, toolchain checks and a keypair-blocking sandbox on macOS.

Who it’s for

Solana developers who use, or are about to set up, the Solana MCP or skill in Claude Code, Codex or Cursor.

Last checked

November 16, 2026, against Oh My Sol 0.1.0

## What are the Solana Developer MCP and the solana-dev skill?

The [Solana Developer MCP](https://mcp.solana.com/) is a remote MCP server at `https://mcp.solana.com/mcp` that needs no API key. It exposes five tools: `list_sections`, `get_documentation`, `Solana_Documentation_Search`, `Solana_Expert__Ask_For_Help` and `program_autofixer`, which checks Anchor and Pinocchio program Rust for security antipatterns. Its site has setup steps for Codex, Claude Code, Cursor, Windsurf and VS Code.

The [solana-dev skill](https://github.com/solana-foundation/solana-dev-skill) is an MIT-licensed Agent Skill from the Solana Foundation. It covers `@solana/kit`, Anchor, Pinocchio, Surfpool, LiteSVM and Mollusk testing, Codama, security patterns and toolchain troubleshooting, and works with Claude Code, Codex, GitHub Copilot, Gemini CLI, Cursor, Windsurf, Cline and OpenCode. Install it with `npx skills add solana-foundation/solana-dev-skill`.

Both give knowledge to an agent you already use. Neither runs your program or decides when work is finished.

## How is Oh My Sol different?

Oh My Sol (OMS) is a terminal harness. It runs your model, gives it Solana references and tools, runs its commands in a sandbox, and decides when a task is done by checking it.

|  | Solana MCP and solana-dev skill | Oh My Sol 0.1.0 |
| --- | --- | --- |
| What it is | Documentation server and instructions for your existing agent | A harness that runs your model |
| Solana references | Retrieval and search over Solana documentation | Offline reference for 50 programs and 1,559 instructions, a pinned Solana documentation set, then the official Solana MCP server |
| Works offline | The MCP server needs a network; the skill is local files | Built-in reference and error tables work offline |
| Program checks | `program_autofixer` for Anchor and Pinocchio antipatterns | Offline static review with `/review` |
| Error decoding | The ask-for-help tool, with your error output | `/error 3012`, `/error 0xbc4` and `/tx <signature>` |
| Local chain | The skill documents Surfpool for your own setup | Surfpool chain built in, with `/chain`, `/airdrop`, `/account` and `/rewind` |
| When a task is done | Your agent decides | Each task runs in its own Git worktree, and a separate check runs your requirements on a fresh offline chain |
| Toolchain checks | The skill has compatibility tables | `oms toolchain check` against pinned Anchor, Agave and platform-tools versions |
| Keypair access | Depends on your agent | On macOS, a Seatbelt sandbox always blocks `~/.config/solana` and `~/.ssh` |
| Cost | Free; the MCP server needs no API key | Free and MIT-licensed; you bring your own model access |

## Does Oh My Sol use the MCP and the skill?

Yes. When the model needs a fact, OMS points it at its built-in references and documentation tools first, then the official Solana MCP server (as `solana_docs_search`, `solana_ask`, `solana_list_sections` and `solana_get_documentation`), then general web search and fetch. `/web off` or `--no-web` turns web search, fetch and the MCP off.

The system prompt also carries a reviewed reference pack built from the solana-dev skill and the Helius `helius` and `svm` skills. See [Search](https://barestate.xyz/docs/concepts/search) and [Solana references](https://barestate.xyz/docs/concepts/solana-reference).

## Which should I use?

- **Add the Solana MCP and the solana-dev skill** to the agent or editor you already use when you want Solana documentation and patterns there. Both are free and quick to set up.
- **Use Oh My Sol** when you want the model to run your program on a local chain, keep working until your requirements pass, decode errors and check toolchain versions for you, and keep commands away from your keypair on macOS. It already includes the MCP server and the skill’s content.

## Frequently asked questions

Does Oh My Sol use the Solana Developer MCP?

Yes. When web access is on, Oh My Sol (OMS) calls the official Solana MCP server at https://mcp.solana.com/mcp for documentation search, questions, section lists and documents, after its own built-in references and before general web search. The server’s program_autofixer tool is not exposed in OMS.

Is the solana-dev skill included in Oh My Sol?

Its content is. The OMS system prompt carries a reviewed reference pack built from the MIT-licensed Solana Foundation solana-dev skill and the Helius helius and svm skills. You do not need to install the skill separately.

Can I add the Solana MCP to Claude Code or Codex instead?

Yes. The MCP server and the skill work with any agent that supports them, at no cost. OMS adds what they do not do: it runs your program on a local Surfpool chain, decodes errors, checks your toolchain, and closes a task only when your requirements pass. With the same model, OMS beats both Codex CLI and Claude Code on Solana Bench and fresh Solana tasks.

What does Oh My Sol add on top of the MCP and skill?

A local Surfpool chain, a Git worktree per task, a check that runs your requirements on a fresh offline chain before a task closes, an offline reference for 50 programs, error decoding with /error and /tx, toolchain checks against pinned Anchor, Agave and platform-tools versions, a budget ledger, and on macOS a sandbox that always blocks keypair folders.

Does Oh My Sol work offline?

Yes. Its built-in program reference and error tables work offline, and the local chain runs on your machine. You can turn off web search, fetch and the Solana MCP with /web off or the --no-web flag.

## Try it on your own program

Oh My Sol 0.1.0 runs on macOS and Linux, and on Windows through WSL 2. You need Node 22.19.0 or newer and Git. You bring your own model access: an API key, a ChatGPT subscription or a Claude subscription.

```
npx @barestate/oms doctor --install
npx @barestate/oms
```

[Read the docs](https://barestate.xyz/docs) · [See the benchmarks](https://barestate.xyz/oh-my-sol#benchmarks)
