orquestra mcp connect
- Repo stars 0
- Author repo skills-registry
- Domain
- AI
- Author-declared agents
- No explicit declaration found; this is not inferred or tested compatibility
- Static check
- 88 / 100 · heuristic scan, not runtime safety proof
- Runtime evidence
- Not run; no isolated runtime test evidence is currently recorded
- Author / version / license
- @tomevault-io · no license declared
- Token usage
- Lean
- Setup complexity
- Plug-and-play
- External API key
- Not required
- Operating systems
- macOS · Linux · Windows
- Runtime requirements
- Node.js >=18
- Detected file/system behavior
-
- Read-only
- Network behavior
- External requests
- Install commands
- None (reference only)
Heads up: Tool permissions are not declared; actual access depends on the runtime.
# Orquestra MCP — Connection Setup
MCP endpoint: `https://api.orquestra.dev/mcp` (Streamable HTTP, stateless)
## Claude Desktop
File: `~/Library/Application Support/Claude/claude_desktop_config.json`
```json
{
"mcpServers": {
"orquestra": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/client-streamable-http",
"https://api.orquestra.dev/mcp"
]
}
}
}
```
Restart Claude Desktop after saving.
## Cursor
File: `.cursor/mcp.json` (project) or `~/.cursor/mcp.json` (global)
```json
{
"mcpServers": {
"orquestra": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/client-streamable-http",
"https://api.orquestra.dev/mcp"
]
}
}
}
```
## Claude Code (CLI)
```bash
claude mcp add orquestra --transport http https://api.orquestra.dev/mcp
```
Or in `.claude/settings.json`:
```json
{
"mcpServers": {
"orquestra": {
"type": "http",
"url": "https://api.orquestra.dev/mcp"
}
}
}
```
## Verify Connection
After connecting, ask Claude:
> "List the tools available in the orquestra MCP server"
You should see 8 tools: `search_programs`, `list_instructions`, `build_instruction`,
`list_pda_accounts`, `derive_pda`, `read_llms_txt`, `get_ai_analysis`, `simulate_instruction`.
## Troubleshooting
| Symptom | Fix |
|---------|-----|
| Tools not appearing | Restart the client after config change |
| `npx` not found | Install Node.js ≥ 18 |
| Connection refused | Check internet access to `api.orquestra.dev` |
| `search_programs` returns empty | The program may not be indexed — upload IDL at orquestra.dev |
| Wrong tool name format | Tool names use underscores: `search_programs`, NOT `searchPrograms` |
## Agent Pipeline (optional)
To install the full Orquestra agent pipeline (researcher → builder → signer):
```bash
bash <(curl -fsSL https://raw.githubusercontent.com/berkayoztunc/orquestra/main/install-skills.sh)
```
Agents installed: `orquestra`, `orquestra-researcher`, `orquestra-pda-explorer`,
`orquestra-tx-builder`, `orquestra-simulator`, `orquestra-signer`
---
> Source: [berkayoztunc/orquestra](https://github.com/berkayoztunc/orquestra) — distributed by [TomeVault](https://tomevault.io).
<!-- tomevault:4.0:skill_md:2026-05-23 -->
Sections and files
Listed in source order.
sections -> Claude Desktop → Cursor → Claude Code (CLI) → Verify Connection → Troubleshooting → Agent Pipeline (optional)
terms -> Restart Claude Desktop after saving. · --- > Source: [berkayoztunc/orquestra](https://github.com/berkayoztunc/orquestra) — distributed by [TomeVault](https://tomevault.io).
files/cmd -> https://api.orquestra.dev/mcp · ~/Library/Application Support/Claude/claude_desktop_config.json · .cursor/mcp.json · ~/.cursor/mcp.json · .claude/settings.json · search_programs · list_instructions · build_instruction
body sha256 -> 0928b5e80fde
Claude Desktop
File:
~/Library/Application Support/Claude/claude_desktop_config.jsonRestart Claude Desktop after saving.Cursor
File:
.cursor/mcp.json(project) or~/.cursor/mcp.json(global)Claude Code (CLI)
Or in
.claude/settings.json:Verify Connection
After connecting, ask Claude: "List the tools available in the orquestra MCP server" You should see 8 tools:
search_programs,list_instructions,build_instruction,list_pda_accounts,derive_pda,read_llms_txt,get_ai_analysis,simulate_instruction.Troubleshooting
Symptom · Fix Tools not appearing · Restart the client after config change
npxnot found · Install Node.js ≥ 18 Connection refused · Check internet access toapi.orquestra.devsearch_programsreturns empty · The program may not be indexed — upload IDL at orquestra.dev