Skill

r-mcptools

Use when code loads or uses mcptools (library(mcptools), mcptools::), connecting AI agents to R sessions via MCP, or exposing R as an MCP server for Claude Code or VS Code

npx claudepluginhub arthurgailes/r-package-skills --plugin r-package-skills

Tool Access

This skill uses the workspace's default tool permissions.

Preview

**mcptools lets AI agents INTO your R session.** Agents (Claude Code, VS Code, etc.) can run R code, query data, call functions in your live R environment.

Supporting Assets

references/API.mdreferences/package-docs.mdreferences/server.md

SKILL.md

Similar Skills

Configure MCP Server

---

agent-almanac

r-btw

Use when code loads or uses btw (library(btw), btw::), providing R session context to LLMs, registering tools for ellmer chat, or copying R object descriptions to clipboard

2 files

r-package-skills

mcp-server

Builds Model Context Protocol (MCP) servers in Ruby using the mcp gem. Guides tools, prompts, resources, design principles like context preservation, domain vocabulary, tool budgeting, and security.

13 files

mcp

Stats

Stars10

Forks1

Last CommitApr 24, 2026

Actions

View Source View Plugin View on GitHub View README

Help us improve

Share bugs, ideas, or general feedback.

mcptools: R as Model Context Protocol Server

Overview

mcptools lets AI agents INTO your R session. Agents (Claude Code, VS Code, etc.) can run R code, query data, call functions in your live R environment.

btw vs mcptools: btw gives tools TO ellmer (R → LLM). mcptools lets agents INTO R (LLM → R).

Install: install.packages("mcptools")

References

Read references/API.md before writing code.

references/API.md - Complete function reference
references/package-docs.md - Setup and configuration
references/server.md - MCP server setup and agent configuration

When to Use

Let Claude Code/VS Code run R code
Give agents access to live R session
Expose R functions as MCP tools
Query R data stores from agents

When NOT to Use

Want to call LLMs FROM R (use r-ellmer)
Just need R object descriptions (use r-btw)
Building chatbot in R (use r-ellmer + r-btw)

Quick Reference

library(mcptools)

# In R console (each startup, NOT in scripts)
mcp_session()

# Now Claude Code can:
# - Run R code
# - Query data frames
# - Call your R functions
# - Access documentation

CRITICAL: Call mcp_session() in console at each R startup, NOT in scripts.

Common Mistakes

Issue	Solution
btw vs mcptools confusion	btw = tools TO chat; mcptools = agent INTO R
mcp_session() in scripts	Call in console, each startup
Expecting clipboard copy	mcptools is for agent access, not clipboard
Session not detected	Restart R, call mcp_session() in console

Core Functions

Session Management:

mcp_session(): Initialize MCP session (console only, per startup)
mcp_mcp_server(): Launch MCP server

Advanced

See references/ for:

API.md: Complete function reference
server.md: R as MCP server details
Package docs: Full package documentation

Integration

With Claude Code: Call mcp_session() in R console With ragnar: Agents can query ragnar stores Cross-package patterns: See r-ai meta-skill