Skip to content

tymrtn/tavily-mcp-licensed

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

148 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

GitHub Repo stars npm smithery badge

Tavily MCP (Licensed Fork)

Fork of tavily-ai/tavily-mcp with Copyright.sh licensing:

  • automatic ai-license discovery
  • optional x402-aware fetch (402 + payment-required: x402)
  • usage logging to the Copyright.sh ledger

Tool names remain tavily-*. When following upstream install instructions, replace tavily-mcp with tavily-mcp-licensed and add the ledger env vars below.

Original repository: https://github.com/tavily-ai/tavily-mcp

Why this fork?

This fork adds compliant licensing checks, optional x402 payment handling, and usage logging so developers can fetch content with clear rights and auditability.

Quickstart

  1. Get a Tavily API key: https://app.tavily.com/home
  2. Get a Copyright.sh ledger key: https://portal.copyright.sh
    • Sign up → complete onboarding → open API Keys → create a key (shown once)
  3. Run:
env TAVILY_API_KEY=your_tavily_key COPYRIGHTSH_LEDGER_API_KEY=your_ledger_key npx -y tavily-mcp-licensed
  1. Configure your MCP client:
{
  "mcpServers": {
    "tavily-licensed": {
      "command": "npx",
      "args": ["-y", "tavily-mcp-licensed"],
      "env": {
        "TAVILY_API_KEY": "your_tavily_key",
        "COPYRIGHTSH_LEDGER_API_KEY": "your_ledger_key"
      }
    }
  }
}

Configuration

Required:

  • TAVILY_API_KEY
  • COPYRIGHTSH_LEDGER_API_KEY (needed for license acquisition + usage logging)

Optional:

  • COPYRIGHTSH_LEDGER_API (default: https://ledger.copyright.sh)
  • ENABLE_LICENSE_TRACKING (default: true)
  • ENABLE_LICENSE_CACHE (default: false)

License-aware options (search/extract/crawl):

  • fetch, stage, distribution, estimated_tokens, max_chars, payment_method

Unavailable policy:

  • License denied or HTTP 401/403/402 results are returned with an unavailable reason and redacted content
  • Unknown license remains best-effort

Note: Tavily's hosted MCP (https://mcp.tavily.com/mcp) does not include licensing. Use this fork locally for compliant licensing behavior.

Upstream docs

About

Production ready MCP server with real-time search, extract, map & crawl.

Resources

License

Stars

0 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages

  • JavaScript 85.8%
  • TypeScript 13.5%
  • Dockerfile 0.7%