npm package: @occirank/textbulker-mcp
Description: Model Context Protocol server for 1492vision API
Author: Anthropic, PBC
Latest version: 1.0.17

# 1492 Vision MCP Server

A Model Context Protocol (MCP) server for interacting with the 1492 Vision API.  
This server allows easy integration with Claude for Desktop, N8N, and other MCP-compatible clients.



## Features

- Exposes 1492 Vision API functionality through MCP tools
- Provides prompts for common SEO tasks
- Easy integration with workflow automation tools like N8N


## Tools

#### 1. Beta Tools

  - **beta_test**<br>
    - Perform simple authenticated test.<br>

  - **beta_api_quota**<br>
    - Returns the user quota (for API calls) remaining for the day.<br>

  - **beta_host_batch**<br>
    - Rreturns the top 10 hosts with the most articles of the domain given from the urls list.<br>
    - Inputs:<br>
        - `urls` (string[]): List of requested urls.<br>
        - `days` (integer): Given period of search.<br>
        - `lang` (string): Language of the output.<br>

  - **beta_entities_bag_list**<br>
    - Returns the list of entities bags for the user.<br>

  - **beta_entities_bag_related_entities**<br>
    - Returns the list of related entities for the given bag.<br>
    - Inputs:<br>
        - `bag_uuid` (string): Uuid of the bag.<br>
        - `lang` (string): Language of the output.<br>
        - `extra_entities` (boolean): If True, includes extra entities (more exotic entities).<br>

  - **beta_entities_bag_latest_articles**<br>
    - Returns the latest articles for the given bag.<br>
    - Inputs:<br>
        - `bag_uuid` (string): Uuid of the bag.<br>
        - `days` (integer): Given period of search.<br>
        - `lang` (string): Language of the output.<br>
        
  - **beta_entities_bag_best_articles**<br>
    - Returns the top 20 domains for the given bag.<br>
    - Inputs:<br>
        - `bag_uuid` (string): Uuid of the bag.<br>
        - `days` (integer): Given period of search.<br>
        - `lang` (string): Language of the output.<br>

  - **beta_entities_bag_top_domains**<br>
    - Retrieves a list of synonyms related to a given keyword.<br>
    - Inputs:<br>
        - `bag_uuid` (string): Uuid of the bag.<br>
        - `days` (integer): Given period of search.<br>
        - `lang` (string): Language of the output.<br>

#### 2. Wip Tools
  - **wip_livetrends**<br>
    - Retrieves livetrends at different importance levels.<br>
    - Inputs:<br>
        - `lang` (string): Language of the output.<br>
        - `min` (integer): Uuid of the bag.<br>
        - `no_thing` (boolean): "".<br>
        - `less_sport` (boolean): "".<br>
        - `topic_id` (integer): Id of the topic.<br>
        
  - **wip_host_folders**<br>
    - Returns the folders for the given host.<br>
    - Input:<br> 
        - `host` (string): Host to look for.<br>

  - **wip_host_latest_articles**<br>
    - Returns the latest articles for the given host.<br>
    - Inputs:<br>
        - `host` (string): Host to look for.<br>
        - `days` (integer): Given period of search.<br>
        - `lang` (string): Language of the articles.<br>
        - `folder` (string): "".<br>

  - **wip_host_best_articles**<br>
    - Returns the best articles for the given host.<br>
    - Inputs:<br> 
        - `host` (string): Host to look for.<br>
        - `days` (integer): Given period of search.<br>
        - `lang` (string): Language of the articles.<br>
        - `folder` (string): "".<br>

  - **wip_urls_entities**<br>
    - Returns the entities for the given urls (max 50 per call).<br>
    - Inputs:<br>
        - `urls` (string[]): List of requested urls.<br>
        - `days` (integer): Given period of search.<br>
        - `lang` (string): Language of the articles.<br>

  - **wip_urls_topics**<br>
    - Returns the topics for the given urls (max 50 per call).<br>
    - Inputs:<br> 
        - `urls` (string[]): List of requested urls.<br>
        - `days` (integer): Given period of search.<br>
        - `lang` (string): Language of the articles.<br>

  - **wip_entity_latest_articles**<br>
    - Returns the latest articles for the given entity.<br>
    - Inputs:<br> 
        - `entity_id` (string): Id of the requested entity.<br>
        - `days` (integer): Given period of search.<br>
        - `lang` (string): Language of the articles.<br>

  - **wip_entity_best_articles**<br>
    - Returns the best articles for the given entity.<br>
    - Inputs:<br>
        - `entity_id` (string): Id of the requested entity.<br>
        - `days` (integer): Given period of search.<br>
        - `lang` (string): Language of the articles.<br>

  - **wip_entity_related_entities**<br>
    - Returns the related entities for the given entity.<br>
    - Inputs:<br> 
        - `entity_id` (string): Id of the requested entity.<br>
        - `days` (integer): Given period of search.<br>
        - `lang` (string): Language of the articles.<br>




## Configuration
1. Sign up for an [1492 Vision account](https://1492.vision/login.php?action=register).
2. Choose a plan.
3. Generate your API key.
4. Use the API key for the 1492 Vsion server in the Claude Desktop configuration file.

## Usage with Claude Desktop

Add this server to your Claude Desktop configuration file `claude_desktop_config.json`:

### NPX
```bash
{
  "mcpServers": {
    "1492vision": {
      "command": "npx",
      "args": [
        "@occirank/1492vision"
      ],
      "env": {
        "ACCESS_API_KEY": "your_1492vision_api_key"
      }
    }
  }
}
```


### License
MIT