Plugin Installation

Install the Nimble plugin and turn Claude Code or Cursor into a web data powerhouse. Search, extract, scrape, and build reusable extraction agents, all from your AI coding assistant. The plugin bundles the Nimble skills and an MCP server connection into a single package.

What’s Included

Component	Description
nimble-web-expert skill	Get live web data instantly. Search, extract, map, and crawl via Nimble CLI. Also runs Extraction Templates and Web Search Agents
MCP server config	Pre-configured connection to the Nimble MCP server

Skills Overview

nimble-web-expert

Get web data immediately. Fast, one-off extractions. Scrape pages, fetch URLs, search the web, crawl site sections. This is the only way your AI coding assistant can access live websites.Triggers: Fetching any URL, scraping data, web search, bulk crawling, running pre-built agents

Prerequisites

Nimble CLI: Install globally:

npm i -g @nimble-way/nimble-cli

Nimble API Key: Sign up and generate a key from your Settings → API Keys
Set the environment variable:

export NIMBLE_API_KEY="your-api-key-here"

Or add to ~/.claude/settings.json (Claude Code):

{
  "env": {
    "NIMBLE_API_KEY": "your-api-key-here"
  }
}

Install by Platform

Run this command in your terminal

Installs the Nimble skills and configures the MCP server.

claude plugin marketplace add Nimbleway/agent-skills && \
claude plugin install nimble@nimble-plugin-marketplace

Verify installation

Run /mcp and confirm nimble appears in your connected servers.

Alternative: local plugin directory

Clone the repo and load it as a local plugin:

git clone https://github.com/Nimbleway/agent-skills.git
claude --plugin-dir /path/to/agent-skills

Install from the plugin directory

One click, from the Anthropic and Partners directory inside Claude.

Approve the scopes in your browser. There is no API key to paste or manage.

Step-by-step, with screenshots

Open the plugin directory

In a new Cowork task, click the + button, hover Plugins, then click Manage plugins.

Cowork new-task input with the + menu open showing Plugins > Manage plugins

Alternatively, from the Customize screen, click + next to Personal plugins and choose Browse plugins.

Customize > Personal plugins with the Browse plugins / Create plugin menu open

Find Nimble

Switch to the Plugins tab, select Anthropic & Partners, and search for Nimble.

Directory with Plugins tab and Anthropic & Partners filter, search 'Nimble' showing the Nimble plugin card

Install

Open the Nimble plugin and click Install. The plugin’s skills, agents, and MCP connector register automatically.

Nimble plugin detail page showing 14 skills, 2 agents, and 1 MCP connector

Connect the MCP server

Nimble now appears under Personal plugins in Customize, with Skills, Connectors, and Agents sub-sections.

Customize sidebar showing the installed Nimble plugin with Skills, Connectors, and Agents sub-items

Open Connectors, then click Connect to start OAuth.

Nimble plugin Connectors page with the nimble (CUSTOM) connector and a Connect button

Approve OAuth

Review the permissions Claude is requesting and click Approve to authenticate with your Nimble workspace.

OAuth approval dialog: Claude is requesting access to Nimble with permissions to verify identity, search the web, extract data, manage Web Search Agents, and maintain access offline

Once approved, the Nimble skills, agents, and MCP tools are live across your Cowork conversations.

For more on connecting Nimble to other Claude surfaces, see the Claude AI Connectors guide.

Add the MCP server

One click, then confirm the install in Cursor.

Then replace NIMBLE_API_KEY in Settings → MCP Servers → nimble-mcp-server with your Nimble API key. The deeplink ships a placeholder, not a key.

Add the skills

Teaches the agent which Nimble product fits a given job.

npx skills add Nimbleway/agent-skills -a cursor

Verify installation

Open Settings, then MCP, and confirm nimble-mcp-server is listed.

Manual MCP configuration

Add to .cursor/mcp.json (project) or ~/.cursor/mcp.json (global):

{
  "mcpServers": {
    "nimble-mcp-server": {
      "url": "https://mcp.nimbleway.com/mcp",
      "headers": {
        "Authorization": "Bearer NIMBLE_API_KEY"
      }
    }
  }
}

Restart Cursor for changes to take effect.

The npx skills add step above also copies the Cursor rules into your project.

Alternative: Clone the repo

Clone the repo and open the agent-skills folder in Cursor:

git clone https://github.com/Nimbleway/agent-skills.git

Cursor auto-discovers:

skills/ the Nimble skills
rules/ Cursor rules (auto-loaded)
mcp.json MCP server connection

Add the MCP server

Codex stores MCP configuration in ~/.codex/config.toml, or a project-scoped .codex/config.toml. Add:

[mcp_servers.nimble-mcp-server]
url = "https://mcp.nimbleway.com/mcp"
bearer_token_env_var = "NIMBLE_API_KEY"

Codex reads NIMBLE_API_KEY from your environment at runtime, so the key is never written to the config file.

Add the skills

Installs the Nimble skills into Codex’s skill discovery paths (~/.agents/skills/).

npx skills add Nimbleway/agent-skills -a codex

Verify installation

Run /mcp inside the Codex TUI to confirm the server, and /skills to confirm the skills. Restart Codex if they do not appear.

Cortex Code, Snowflake’s native AI coding agent for the terminal, installs the Nimble MCP server with a single command. OAuth handles authentication — no API key required.

Run this command in your terminal

Adds the Nimble MCP server to Snowflake’s terminal agent.

cortex mcp add nimble https://mcp.nimbleway.com/mcp --transport http

No Authorization header is needed. The Nimble MCP server advertises OAuth and Cortex Code runs the flow on first connection, storing tokens in your OS keychain.

Run cortex mcp list to confirm, then cortex mcp start.

Cortex Code writes the server to ~/.snowflake/cortex/mcp.json. Once nimble shows as connected, its tools are namespaced as mcp__nimble__search, mcp__nimble__extract, mcp__nimble__map, and mcp__nimble__crawl.For organization-wide rollout via managed settings, see the full Cortex Code integration guide.

Run this command in your terminal

Installs the Nimble skills into your project.

npx skills add Nimbleway/agent-skills

Verify installation

Run npx skills add Nimbleway/agent-skills --list to see what was installed.

The skills reach Web Search Agents and Extract Templates through the MCP server. After installing via npx skills, connect the server manually:

claude mcp add --transport http nimble-mcp-server https://mcp.nimbleway.com/mcp \
  --header "Authorization: Bearer ${NIMBLE_API_KEY}"

What’s Next

Build Your First Agent

End-to-end tutorial: competitive price analysis across Amazon, Walmart, and Nike, from a single prompt

Ask Nimble

Prefer a visual interface? Create agents in the browser

Talk to Sales

Need enterprise scale or managed delivery?

Source Code

View the full plugin source on GitHub

Agent Skills

MCP Server

Partnerships

Connectors

Proxy

What’s Included

Skills Overview

Prerequisites

Install by Platform

Alternative: local plugin directory

Step-by-step, with screenshots

What’s Next

Build Your First Agent

Ask Nimble

Talk to Sales

Source Code

​What’s Included

​Skills Overview

​Prerequisites

​Install by Platform

​Alternative: local plugin directory

​Step-by-step, with screenshots

​What’s Next

Build Your First Agent

Ask Nimble

Talk to Sales

Source Code

What’s Included

Skills Overview

Prerequisites

Install by Platform

Alternative: local plugin directory

Step-by-step, with screenshots

What’s Next