Quick Start

Get started with Unbrowse in 5 minutes using the Model Context Protocol (MCP).

1. Get API Key

Sign up at agent.unbrowse.ai and generate an API key.

2. Install Unbrowse MCP Server

Unbrowse is integrated via the Model Context Protocol (MCP), which works with Claude Desktop, Continue.dev, and other MCP-compatible AI tools.

Via Smithery (Recommended)

Install the Unbrowse MCP server from Smithery:

npx @smithery/cli install @lekt9/unbrowse-mcp --client claude

Or visit: https://smithery.ai/server/@lekt9/unbrowse-mcp

Manual Installation

Add to your MCP client configuration:

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "unbrowse": {
      "command": "npx",
      "args": ["-y", "@lekt9/unbrowse-mcp"],
      "env": {
        "UNBROWSE_API_KEY": "your_api_key_here"
      }
    }
  }
}

Continue.dev (.continue/config.json):

{
  "experimental": {
    "modelContextProtocolServers": [
      {
        "transport": {
          "type": "stdio",
          "command": "npx",
          "args": ["-y", "@lekt9/unbrowse-mcp"]
        },
        "env": {
          "UNBROWSE_API_KEY": "your_api_key_here"
        }
      }
    ]
  }
}

3. Basic Usage

Once installed, your AI assistant can use Unbrowse abilities through natural language:

Example: LinkedIn Post

You: "Post this announcement to LinkedIn with the image from my desktop"

AI Assistant:
[Uses Unbrowse MCP to search for "LinkedIn post with image" ability]
[Executes the ability with your content]
✅ Posted to LinkedIn: https://linkedin.com/feed/update/...

Example: Flight Search

You: "Find me flights from NYC to Tokyo between Jan 10-15, under $800"

AI Assistant:
[Uses Unbrowse to search flight abilities]
[Executes searches across multiple airlines in parallel]

Found 12 flights:
1. Japan Airlines - $742 (1 stop, 14h 30m)
2. ANA - $780 (direct, 13h 50m)
3. United - $795 (2 stops, 18h 15m)
...

Example: Investment Research

You: "Get competitor traffic data for snowflake.com from SpyFu"

AI Assistant:
[Uses Unbrowse to execute SpyFu competitor search]

Traffic Analysis for snowflake.com:
- Monthly visits: 2.4M (↑15% vs last month)
- Organic keywords: 18,500
- Top competitors: Databricks, BigQuery, Redshift
- Traffic trend: Growing steadily

4. Available MCP Tools

The Unbrowse MCP server provides these tools to your AI assistant:

unbrowse_search

Search for available abilities by natural language query.

Parameters:

• query (string): What you want to do (e.g., "book flight", "post to LinkedIn")

• limit (number, optional): Max results to return (default: 10)

Returns: List of matching abilities with descriptions and parameters.

unbrowse_execute

Execute a specific ability.

Parameters:

• ability_id (string): ID of the ability to execute

• params (object): Parameters required by the ability

Returns: Structured result from the ability execution.

5. How It Works Behind the Scenes

When your AI assistant uses Unbrowse:

6. Pricing

Usage fees are automatically handled by Unbrowse:

• Search: $0.0001 per query (finding abilities)

• Execute: $0.001 per action (running abilities)

Important: These fees are for using Unbrowse abilities, not for end-user purchases. For example:

• Searching for flight abilities: $0.0001

• Executing flight search ability: $0.001

• Actual flight purchase: Handled by the airline's payment system (not Unbrowse)

Payment is handled automatically via your Unbrowse account balance. X402 smart contracts distribute fees:

• 40% → Website owner

• 40% → FDRY Treasury (buyback + burn)

• 19% → Ability creator (indexer)

• 1% → Infrastructure

7. Rate Limits

Free tier:

• 1,000 searches/day

• 100 executions/day

Pro tier:

• 10,000 searches/day

• 1,000 executions/day

Enterprise:

• Unlimited (contact sales)

8. Error Handling

The MCP server handles errors gracefully and returns structured error information:

AI Assistant: "Posting to LinkedIn..."

Error: Rate limit exceeded (100 executions/day limit reached)
Suggestion: Upgrade to Pro tier or wait until tomorrow

AI Assistant: "It looks like you've hit your daily limit. Would you like me to try again tomorrow or upgrade your account?"

Common Use Cases

Social Media Management

"Post this update to LinkedIn and Twitter simultaneously"
"Schedule a thread on X for next Monday at 9am"

Travel Booking

"Find the cheapest flights to Paris next month"
"Book a hotel near Times Square for this weekend"

Data Research

"Get traffic stats for competitor.com from SimilarWeb"
"Pull company reviews from Glassdoor for DataCo"

Productivity

"Create a Jira ticket for this bug with high priority"
"Send this report to the #engineering Slack channel"

Next Steps

• MCP Server Documentation - Advanced MCP configuration

• Integration Examples - More detailed examples

• API Reference - Complete API docs

• Authentication - Auth methods

---

Questions? Join our Discord