pinescript-mcp 0.4.0

MCP server providing Pine Script v6 documentation for AI assistants

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

Usage with Claude Code

Add to .mcp.json in your project (recommended):

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

Usage with Claude Desktop

Add to ~/.config/claude/claude_desktop_config.json:

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

Usage with Google Antigravity

Add to ~/.gemini/antigravity/mcp_config.json:

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

Or use the public HTTP server (no install):

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

Version Pinning

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

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

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

Alternative: pip install

If you prefer pip over uvx:

pip install pinescript-mcp==0.2.1

Note: "command": "pinescript-mcp" only works if the install location is in your PATH. The uvx method above is more reliable as it handles environments automatically.

Public Server (No Install Required)

Connect directly to the hosted server - no Python or uvx needed:

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

Available Tools

Tool	Description
list_docs()	List all documentation files with descriptions
get_section(path, header)	Read a specific section from a documentation file
get_doc(path)	Read a specific documentation file
search_docs(query)	Full-text search across all docs
get_functions(namespace)	List valid functions (ta, strategy, etc.)
validate_function(name)	Check if a function exists in Pine v6
resolve_topic(query)	Map a question to relevant docs
get_manifest()	Get routing guidance for topics

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

Development

# Clone and install locally
git clone https://gitlab.com/articat1066/pinescript-v6-mcp
cd pinescript-mcp
pip install -e .

# Run the server
pinescript-mcp

License

MIT