pinescript-mcp

MCP server providing Pine Script v6 documentation for AI assistants (Claude, etc.).

Enables AI to:

Look up Pine Script functions and validate syntax
Access official documentation for indicators, strategies, and visuals
Understand Pine Script concepts (execution model, repainting, etc.)
Generate correct v6 code with proper function references

Quick Start (stdio)

Works with Claude Code, Claude Desktop, Gemini CLI, and any MCP client that supports stdio:

{
  "mcpServers": {
    "pinescript-docs": {
      "type": "stdio",
      "command": "uvx",
      "args": ["pinescript-mcp"]
    }
  }
}

Public Server (No Install Required)

No Python or uvx needed — connect directly to the hosted server.

Streamable HTTP — Claude Code, mcpServers with type field):

{
  "mcpServers": {
    "pinescript-docs": {
      "type": "http",
      "url": "https://pinescript-mcp.fly.dev/mcp"
    }
  }
}

Windsurf — uses its own shape (see Windsurf docs). Edit ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "pinescript-docs": {
      "serverUrl": "https://pinescript-mcp.fly.dev/mcp"
    }
  }
}

ChatGPT — no config file. In ChatGPT, go to Settings → Connectors → Create and paste https://pinescript-mcp.fly.dev/mcp into the Server URL field. Developer Mode must be enabled (see OpenAI Developer Mode guide).

Claude.ai — add via the web UI's MCP connector settings, not a JSON file.

Version Pinning

Documentation is bundled in the package — each version contains a frozen snapshot. For reproducible agent behaviour, pin to a specific version:

{
  "mcpServers": {
    "pinescript-docs": {
      "command": "uvx",
      "args": ["pinescript-mcp==0.7.6"]
    }
  }
}

Without pinning, uvx pinescript-mcp gets the latest version.

Available Tools

Tool	Description
`resolve_topic(query)`	Fast lookup for exact API terms (`ta.rsi`, `repainting`)
`search_docs(query)`	Grep for exact strings across all docs
`list_docs()`	List all documentation files with descriptions
`list_sections(path)`	List `##` headers in a doc file (for navigating large files)
`get_doc(path)`	Read a specific documentation file
`get_section(path, header)`	Read a specific section by header
`get_functions(namespace)`	List valid functions (ta, strategy, etc.)
`validate_function(name)`	Check if a function exists in Pine v6
`list_resources()`	Browse available documentation resources
`read_resource(uri)`	Read a doc resource by URI (e.g. `docs://manifest`)
`list_prompts()`	List available prompt templates
`get_prompt(name, arguments)`	Render a prompt template with arguments

Available Prompts

Prompt	Description
`debug_error(error, code)`	Analyze a Pine Script compilation error
`convert_v5_to_v6(code)`	Convert Pine Script v5 code to v6 syntax
`explain_function(name)`	Explain a Pine Script function in detail

Available Resources

URI	Description
`docs://manifest`	Start here — routing guide for Pine Script questions
`docs://functions`	Complete Pine Script v6 function list (JSON)
`docs://{path}`	Any doc file by path (e.g. `concepts/timeframes.md`)

Example Queries

"How do I create a trailing stop in Pine Script?"
"What's the difference between var and varip?"
"Is ta.supertrend a valid function?"
"How do I avoid repainting with request.security?"

Documentation Coverage

The server bundles comprehensive Pine Script v6 documentation:

Concepts: Execution model, timeframes, colors, methods, objects, common errors
Reference: Types, variables, constants, keywords, operators, annotations
Functions: Technical analysis (ta.*), strategies, requests, drawings, collections
Visuals: Plots, fills, shapes, tables, lines, boxes, backgrounds
Writing Scripts: Style guide, debugging, optimization, limitations

Why Use This?

AI models often hallucinate Pine Script functions or use deprecated v5 syntax. This MCP server grounds the AI in actual v6 documentation, preventing:

Made-up function names (e.g., ta.hull doesn't exist, use ta.hma)
Deprecated syntax from v4/v5
Incorrect parameter orders
Missing required arguments

Skills

Combine with skills for even more control available at bouch.dev/products/pine-strategy-builder.

Development

# Clone and install locally
git clone https://github.com/paulieb89/pinescript-mcp
cd pinescript-mcp
pip install -e .

# Run the server
pinescript-mcp

License

MIT