# Nimble MCP Server (verified)

The Nimble MCP Server gives AI agents the ability to search, extract, map, crawl, and structure data from any website in real time. It exposes Nimble’s full web data platform as MCP tools that any co…

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add nimble/nimble-mcp

# Browse available tools
npx -y @smithery/cli@latest tool list nimble/nimble-mcp

# Get full schema for a tool
npx -y @smithery/cli@latest tool get nimble/nimble-mcp nimble_crawl_run

# Call a tool
npx -y @smithery/cli@latest tool call nimble/nimble-mcp nimble_crawl_run '{}'
```

## Direct MCP Connection

Endpoint: `https://nimble.run.tools`

**Required config:**
- `NIMBLE_API_KEY` (header) — Authorization Header: "Bearer {NIMBLE_API_KEY}"

## Tools (18)

- `nimble_crawl_run` — Start a web crawl to extract content from multiple pages on a website.
- `nimble_crawl_status` — Check the status and progress of a running or completed crawl job.
- `nimble_crawl_list` — List crawl jobs, optionally filtered by status.
- `nimble_crawl_terminate` — Cancel a running or queued crawl job.
- `nimble_map` — Discover all URLs on a website by crawling its pages and sitemap.
- `nimble_task_results` — Get the status and results of an async task.
- `nimble_agent_run_async` — Start an asynchronous agent run. Returns immediately with a task ID.
- `nimble_search` — Search the web using Nimble's Search API with configurable content richness.
- `nimble_extract` — Extract and parse content from a specific URL using Nimble's Extract API.
- `nimble_extract_async` — Start an asynchronous URL extraction. Returns immediately with a task ID.
- `nimble_agents_list` — Browse the catalog of pre-built Nimble agents.
- `nimble_agents_get` — Get full details of a specific agent including its input/output schema.
- `nimble_agents_generate` — Start creating a custom agent (initial creation only).
- `nimble_agents_status` — Check the current status of a generate or update session.
- `nimble_agents_run` — Execute an agent against a target URL or set of parameters.
- `nimble_agents_publish` — Save a generated agent so it becomes reusable and searchable.
- `nimble_agents_update_from_agent` — Create an update session from an existing agent (forking when needed).
- `nimble_agents_update_session` — Continue refinement for an existing update/generate session.

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get nimble/nimble-mcp <tool-name>
```