Skip to content

rawtreedb/rawtree

v0.3.1Apache-2.0

Use RawTree to ingest, query, and analyze event data.

GitHubOpen Website

RawTree Agent Skills

A skill and hosted MCP server for working with RawTree, following the Agent Skills format. Available as a plugin for Cursor, Claude Code, Codex, Devin, and any Agent Plugins client, and as a Kiro Power. Includes RawTree's hosted MCP server for tool access.

Install

npx skills add rawtreedb/agent-skills

This installs only the rawtree skill. To also get the RawTree MCP server, install the plugin for your agent below.

Cursor

Cursor reads .cursor-plugin/plugin.json. Once RawTree is available in the Cursor Marketplace, open Customize, search for RawTree, and select Install, or run /add-plugin rawtree in chat. Until then, on a Teams or Enterprise plan add this repository from Dashboard → Plugins & MCPs → Team Marketplaces → Add Marketplace → Import from Repo (https://github.com/rawtreedb/agent-skills). To try it locally, clone the repository into ~/.cursor/plugins/local/rawtree and run Developer: Reload Window.

Claude Code

claude plugin marketplace add rawtreedb/agent-skills
claude plugin install rawtree@rawtree

Inside a session you can run /plugin marketplace add rawtreedb/agent-skills and /plugin install rawtree@rawtree. Then run /mcp, select rawtree, and complete the RawTree sign-in.

Codex

codex plugin marketplace add rawtreedb/agent-skills
codex plugin add rawtree@rawtree

In the Codex app, you can also use Add marketplace with this repository's GitHub URL, then select RawTree from the added source. Authenticate the bundled MCP connection when prompted and start a new task to use the plugin.

Devin

In Devin Cloud, open Customize → Plugins → Personal → Add plugin → From repository and enter https://github.com/rawtreedb/agent-skills. Once indexing finishes, select Connect MCP and complete RawTree's OAuth authorization. Start a new session to use the plugin.

For Devin CLI, when plugins are enabled by your organization:

devin plugins install rawtreedb/agent-skills
devin mcp login rawtree

Devin loads the existing Claude plugin manifest, the bundled MCP configuration, and the shared RawTree skill. Invoke the skill with /rawtree:rawtree. See Devin's plugin documentation.

Grok Bot and Grok Build

Grok Bot lists RawTree on grokbot.dev/plugins/rawtree: add a custom MCP connector pointing at https://mcp.rawtree.com/mcp and sign in with RawTree. That page is a community listing and does not install this repository's plugin.

Grok Build reads the .claude-plugin/ catalog in this repository:

grok plugin marketplace add rawtreedb/agent-skills
grok plugin install rawtree --trust

Kiro

In Kiro, open Powers → Add Custom Power → Import power from GitHub and provide this repository URL. For local testing, use Import power from a folder after cloning the repository.

Other agents

Any Agent Plugins client can load the root plugin.json and mcp.json. Other agents can use skills/rawtree/SKILL.md directly.

After installing, connect the MCP server. RawTree uses OAuth, so your client walks you through sign-in on first connect and no API key or header configuration is needed. You need a RawTree account.

Repository Structure

plugin.json                  # Agent Plugins manifest (Codex, Kiro, Agent Plugins clients)
mcp.json                     # Agent Plugins MCP config (streamable-http)
.agents/plugins/
  marketplace.json           # Codex marketplace catalog
.claude-plugin/
  plugin.json                # Claude Code manifest
  marketplace.json           # Claude Code marketplace catalog
.mcp.json                    # Claude Code MCP config (type: http)
.cursor-plugin/
  plugin.json                # Cursor manifest
  marketplace.json           # Cursor marketplace catalog
  mcp.json                   # Cursor MCP config (type: http, placement: server)
POWER.md
skills/
  rawtree/
    SKILL.md
    agents/
      openai.yaml
    references/
      api.md
      cli.md
      dynamic-fields.md
      mcp.md
      performance.md
      query.md

Available Skills

  • rawtree — RawTree guidance for database, ingestion, querying, dynamic-column, and observability workflows.

Examples

The rawtree skill activates automatically when a task involves RawTree. In Kiro, you can also invoke it directly with /rawtree when it is installed as a standalone skill. Other compatible agents can discover it from skills/rawtree/SKILL.md.

Ask an agent

Try prompts such as:

  • “Using RawTree, plan a workflow for evolving event data.”
  • “Design a RawTree ingestion workflow for logs, traces, and metrics.”
  • “Review this RawTree SQL query for bounded, read-only analysis.”
  • “Explain how RawTree Dynamic fields handle nested and mixed-type JSON.”
  • “Using RawTree MCP tools, describe this table and write a bounded query.”

When the RawTree MCP server is connected, the agent can use the appropriate tools for table discovery, ingestion, querying, and logs while following the skill's guidance.

Plugins

This repository follows the Agent Plugins open standard: plugin.json and mcp.json at the root, skills in skills/. It is also a plugin for these platforms through their own manifests, all sharing the single skills/rawtree directory:

  • Cursor: .cursor-plugin/
  • Claude Code: .claude-plugin/ and .mcp.json
  • Codex: root plugin.json and mcp.json, catalog at .agents/plugins/marketplace.json
  • Devin: reuses .claude-plugin/plugin.json, .mcp.json, and skills/

The catalogs point at the plugin at the repository root. No separate copy of the plugin is needed.

Each platform gets its own MCP file because the formats differ: the root mcp.json must stay valid against the Agent Plugins schema (type: streamable-http, no extra fields), Claude Code reads .mcp.json (type: http), and Cursor's .cursor-plugin/plugin.json points at .cursor-plugin/mcp.json, which adds "placement": "server". All three point at https://mcp.rawtree.com/mcp. Keep the versions in plugin.json, .claude-plugin/plugin.json, and .cursor-plugin/plugin.json in sync.

OpenAI package

The root plugin.json is canonical for OpenAI. Its extensions.com.openai.interface provides the listing descriptions, publisher, policy links, icon, capabilities, and starter prompts. Portable clients discover the bundled skills/ and mcp.json at the root. The MCP configuration uses RawTree's hosted endpoint, so the package needs no local server or bundled credentials.

For public publication, submit the plugin through OpenAI's With MCP flow using https://mcp.rawtree.com/mcp, upload the skills/rawtree skill, and complete the required listing, authentication, tool scan, and review tests.

Packaging follows OpenAI's plugin documentation.

Kiro Power

The root plugin.json follows Agent Plugins 1.0 and makes this repository installable as a Kiro Power. The existing skills/rawtree/SKILL.md remains the single source of truth for RawTree guidance; it is not duplicated into a second Power repository.

The root POWER.md provides Kiro's legacy presentation metadata, including the human-readable display name RawTree, description, keywords, and author. It is retained for compatibility with local Power installation while plugin.json remains the portable package manifest.

The root mcp.json uses the Agent Plugins 1.0 MCP schema and connects the Power to RawTree's hosted Streamable HTTP MCP server at https://mcp.rawtree.com/mcp. Kiro manages the MCP connection and authentication. No API keys or authorization headers are stored in this repository.

The repository also includes RawTree's branded Power icon. Kiro's custom GitHub and local Power imports currently use a generic placeholder icon; the icon is available for registry curation or a local Kiro registry entry.

For local MCP development, continue to use the setup in the rawtree-mcp repository, which supports both stdio and a local HTTP server.

Network and Install Disclosure

The plugin itself runs no code. It bundles a skill (Markdown) and an MCP configuration that connects to https://mcp.rawtree.com/mcp using OAuth with RawTree. The skill's CLI reference (skills/rawtree/references/cli.md) documents an optional install command for the RawTree CLI, curl -fsSL https://rawtree.com/install.sh | bash, which downloads and runs the installer script published by RawTree at rawtree.com. The skill tells agents to run it only when rtree is unavailable and installation is within the user's scope. The plugin never runs it automatically.

Support

For support with the RawTree plugins, Power, or MCP integration, contact contact@rawtree.com.

See the Tinybird Privacy Policy for information about privacy and data handling.