Tools & Integrations Reference

This guide provides a comprehensive reference for all tools available in the Bourne AI console. Tools enable your AI agents to interact with external services, perform research, create content, and automate business processes.

Overview

Bourne offers 37 tools organized into six categories:

Social Media (20 tools) - LinkedIn (2), Instagram (13), YouTube (5)
Content Creation (3 tools) - Google Docs, Image Generation, Image Editing
Legal Research (4 tools) - USPTO Trademark Search
Search & Research (8 tools) - Web Search, News Search, Image Search, Web Fetch, Location Services (3), Domain Availability
Business Integration (1 tool) - Generic API Call
Automation (1 tool) - Browser Automation

How to Use Tools

Adding Tools to Agents

Navigate to your agent workflow (see Creating Agent Workflows)
Expand the agent configuration panel
In the Tools section, use the search field to find tools by name
Click on a tool to add it to the agent
For tools requiring credentials, select a credential from the dropdown (see Managing Credentials)
Save your workflow

Tool Requirements

Tools Requiring Credentials (21 tools):

All 20 social media tools (LinkedIn, Instagram, YouTube)
google_docs
browser_automation
apicall

No Credentials Required (16 tools):

All 4 USPTO Trademark Search tools (system-wide API key configured by admin)
All search tools: serper, serper_news, serper_images, fetch
All location tools: geocode_address, search_nearby, get_place_suggestions
Image tools: image_generation, image_editing
domain_availability

LinkedIn Tools (2)

Post to LinkedIn

Tool ID: linkedin_post

Credential Required: Yes (OAuth2 - see LinkedIn Setup)

What It Does: Create and publish posts to LinkedIn with text, images, and videos

Common Use Cases:

Automated content publishing schedules
Cross-platform social media management
Professional network updates
Company page management
Personal branding automation

Example Agent Instruction:

Create a LinkedIn post announcing our new product launch.
Include a professional tone and highlight the key features.
Post it to my LinkedIn profile.

Get LinkedIn Profile

Tool ID: linkedin_get_profile

Credential Required: Yes (OAuth2 - see LinkedIn Setup)

What It Does: Retrieve LinkedIn user profile information

Common Use Cases:

Profile data extraction for CRM
Contact information gathering
Network analysis

Instagram Tools (13)

All Instagram tools require OAuth2 credential (see Instagram Setup)

Get Instagram Account Info

Tool ID: instagram_get_account_info

What It Does: Retrieve Instagram Business account details including username, profile picture, and account metrics

Get Instagram Media

Tool ID: instagram_get_media

What It Does: List all posts from your Instagram Business account

Get Instagram Media By ID

Tool ID: instagram_get_media_by_id

What It Does: Fetch detailed information about a specific post

Create Instagram Media Container

Tool ID: instagram_create_media_container

What It Does: Prepare media (image/video) for publishing - first step of posting workflow

Publish Instagram Media

Tool ID: instagram_publish_media_container

What It Does: Publish a prepared media container to Instagram feed

Check Instagram Publishing Limit

Tool ID: instagram_check_publishing_limit

What It Does: Verify API rate limits before attempting to post

Get Instagram Comments

Tool ID: instagram_get_media_comments

What It Does: Retrieve all comments on a specific Instagram post

Reply to Instagram Comment

Tool ID: instagram_reply_to_comment

What It Does: Post a reply to a user's comment

Delete Instagram Comment

Tool ID: instagram_delete_comment

What It Does: Remove a comment from your posts

Hide/Unhide Instagram Comment

Tool ID: instagram_hide_comment

What It Does: Toggle comment visibility without deleting

Send Instagram Private Reply

Tool ID: instagram_send_private_reply

What It Does: Send a direct message in response to a comment

Get Instagram Media Insights

Tool ID: instagram_get_media_insights

What It Does: View performance metrics for a specific post (likes, reach, impressions, etc.)

Get Instagram Account Insights

Tool ID: instagram_get_account_insights

What It Does: Access account-level analytics and follower demographics

Common Use Cases for Instagram Tools:

Automated comment moderation and customer service
Social media content scheduling and publishing
Community management workflows
Performance analytics and reporting
Brand reputation monitoring
Influencer campaign management

Example Agent Instruction:

Check my Instagram account for new comments on the latest 3 posts.
If any comments contain questions about pricing, reply with our standard pricing message.
Hide any comments that contain spam keywords.
Send me a summary of comment sentiment.

YouTube Tools (5)

All YouTube tools require OAuth2 credential (see YouTube Setup)

Get YouTube Comments

Tool ID: get_youtube_comments

What It Does: Retrieve comments from specified YouTube videos

Post YouTube Reply

Tool ID: post_youtube_reply

What It Does: Reply to comments on your YouTube videos

Get YouTube Channel Info

Tool ID: get_youtube_channel_info

What It Does: Access channel statistics, subscriber count, and metadata

Search YouTube Videos

Tool ID: search_youtube_videos

What It Does: Search for videos on YouTube using keywords

Upload YouTube Video

Tool ID: upload_youtube_video

What It Does: Programmatically upload videos to your YouTube channel

Common Use Cases for YouTube Tools:

Automated comment moderation and responses
Community engagement workflows
Video performance tracking and analytics
Competitive content analysis
Bulk video uploads for content schedules
Creator support automation

Example Agent Instruction:

Get all new comments on my latest video.
Reply to questions about the product with a link to our documentation.
Flag any negative comments for manual review.
Generate a weekly report of comment trends.

Content Creation Tools

Manage Google Docs

Tool ID: google_docs

Credential Required: Yes (OAuth2 - see Google Docs Setup)

What It Does: Create, edit, read, and manage Google Docs documents. Supports markdown formatting for content creation.

Common Use Cases:

Automated report generation
Meeting notes and minutes documentation
Proposal and contract drafting
Content writing workflows
Documentation maintenance
Template-based document creation
Research compilation

Example Agent Instruction:

Create a new Google Doc titled "Weekly Marketing Report - [Today's Date]".
Include sections for: Campaign Performance, Key Metrics, and Next Steps.
Use markdown formatting for headers and bullet points.
Share the document with the marketing team.

Generate Images

Tool ID: image_generation

Credential Required: No

What It Does: Generate AI images from text descriptions using advanced image generation models

Common Use Cases:

Blog post featured images
Social media visual content
Product mockups and concepts
Marketing campaign visuals
Presentation graphics
Custom illustrations

Example Agent Instruction:

Generate a professional hero image for our tech company website.
Style: Modern, clean, tech-focused with abstract geometric patterns.
Colors: Blue and white gradient.
Dimensions: 1920x1080 for web banner.

Edit Images

Tool ID: image_editing

Credential Required: No

What It Does: Edit existing images with AI-powered tools including background removal, filters, and enhancements

Common Use Cases:

Product photo editing and enhancement
Background removal for e-commerce
Image optimization for web and social media
Batch photo processing
Visual content refinement

Legal Research Tools

trademark_search_by_keyword

Display Name: Search Trademarks by Keyword

Credential Required: No (System-wide API key configured by admin)

What It Does: Searches the USPTO (United States Patent and Trademark Office) trademark database for marks matching a given keyword or name. Returns basic information about matching trademarks including serial numbers, owners, filing dates, and current status.

Common Use Cases:

Check if a brand name is available before launching a product
Research competitor trademarks in your industry
Find similar existing marks to avoid infringement
Verify trademark status before filing a new application
Conduct comprehensive trademark clearance searches

Example Agent Instructions:

Search for trademarks containing "TechStart" and show me the top 10 results

Check if there are any existing trademarks for "CloudSync" in the USPTO database

Find all trademarks related to "AI Assistant" and tell me which ones are currently active

Parameters:

keyword: Keyword or trademark name to search for (required)
max_results: Maximum number of results to return (default: 20, max: 100)

Response Format: Returns a list of trademarks with:

serial_number: USPTO trademark serial number
registration_number: Registration number (if registered)
mark_text: The trademark text/name
owner_name: Owner or applicant name
filing_date: Date the application was filed
status: Current trademark status
status_date: Date of the current status

trademark_get_status

Display Name: Get Trademark Status

Credential Required: No (System-wide API key configured by admin)

What It Does: Retrieves comprehensive status information for a specific trademark using its serial number. Includes owner details, filing dates, registration status, goods/services description, and current legal status.

Common Use Cases:

Monitor the status of your own trademark applications
Get detailed information about a competitor's trademark
Verify ownership and registration details before licensing negotiations
Check the goods/services coverage of an existing mark
Track the prosecution history of a trademark application

Example Agent Instructions:

Get the full status details for trademark serial number 88888888

Tell me everything about USPTO trademark 97654321 including who owns it and what it covers

Check the current status and registration date for trademark serial 90123456

Parameters:

serial_number: USPTO trademark serial number (8 digits, required)

Response Format: Returns detailed trademark information including:

serial_number: Trademark serial number
registration_number: Registration number (if registered)
mark_text: The trademark text
owner_name: Owner name
owner_address: Owner mailing address
filing_date: Date filed
registration_date: Date registered (if applicable)
current_status: Current legal status
status_date: Date of current status
goods_services: Description of covered goods/services
international_class: International trademark classification

trademark_search_by_owner

Display Name: Search Trademarks by Owner

Credential Required: No (System-wide API key configured by admin)

What It Does: Finds all trademarks owned by a specific entity by searching for their company name or postcode. Useful for portfolio analysis and competitive research.

Common Use Cases:

Analyze a competitor's complete trademark portfolio
Track all trademark filings by a specific company
Research trademark ownership before business acquisitions
Audit your company's trademark holdings
Identify potential trademark infringement by similar company names

Example Agent Instructions:

Find all trademarks owned by "Apple Inc" and show their status

List all active trademarks registered to "Microsoft Corporation"

Search for trademarks owned by companies with postcode "98052"

Parameters:

owner_search_term: Owner name or postcode to search for (required)
max_results: Maximum number of results to return (default: 20, max: 100)

Response Format: Returns the same trademark information as trademark_search_by_keyword, but filtered by owner:

List of all trademarks owned by the searched entity
Same fields: serial number, mark text, owner, filing date, status

trademark_get_application_metadata

Display Name: Get Trademark Metadata

Credential Required: No (System-wide API key configured by admin)

What It Does: Retrieves complete metadata about a trademark application including attorney information, correspondence addresses, examination history, and all associated filing documents.

Common Use Cases:

Get detailed application history for prosecution analysis
Find attorney or representative information for licensing contacts
Review examination correspondence and office actions
Access complete filing document history
Conduct due diligence for trademark acquisitions

Example Agent Instructions:

Get all metadata and filing history for trademark 88888888

Show me the attorney information and correspondence address for trademark serial 90123456

Retrieve the complete examination history for trademark application 97654321

Parameters:

serial_number: USPTO trademark serial number (8 digits, required)

Response Format: Returns comprehensive metadata including:

serial_number: Trademark serial number
metadata: Complete metadata object containing:
- Attorney/representative information
- Correspondence addresses
- Examination history
- Office action dates
- Filing documents and responses
- Prosecution timeline

Note: All USPTO Trademark Search tools use a system-wide API key configured by your administrator. Users do not need to set up individual credentials. The tools access real-time data from the USPTO TSDR (Trademark Status and Document Retrieval) API.

Search & Research Tools

Search Web

Tool ID: serper

Credential Required: No

What It Does: Search the web using Google search API, returning top results with snippets and URLs

Common Use Cases:

Research and fact-checking
Competitive intelligence gathering
Market research and trends analysis
Content research for writing
General information gathering
Due diligence

Example Agent Instruction:

Search for "best practices for AI agent automation in 2024".
Summarize the top 5 articles' key findings.
Extract any statistics or data points mentioned.
Provide source URLs for all information.

Search News

Tool ID: serper_news

Credential Required: No

What It Does: Search recent news articles from various sources using Google News

Common Use Cases:

Daily news briefings and summaries
Industry news monitoring
Brand mention tracking
Competitor news alerts
Market trend analysis
Crisis monitoring

Example Agent Instruction:

Search for news about [Company Name] from the past 7 days.
Categorize articles by topic (product launches, financial, press coverage).
Summarize key developments and sentiment.

Search Images

Tool ID: serper_images

Credential Required: No

What It Does: Search for images using Google Image Search API

Common Use Cases:

Visual content research
Finding stock photos and references
Product image discovery
Design inspiration gathering
Competitive visual analysis

Retrieve Web Page Content

Tool ID: fetch

Credential Required: No

What It Does: Retrieve and extract full content from any publicly accessible web page

Common Use Cases:

Web scraping for data collection
Article content extraction
Price monitoring from e-commerce sites
Product information gathering
Documentation and knowledge base reading
Content aggregation

Example Agent Instruction:

Fetch the content from https://example.com/blog/latest-post.
Extract the main article text, author name, and publication date.
Summarize the key points in 5 bullet points.
Check if there are any embedded links to related articles.

Location Tools (3)

All location tools require no credentials

Geocode Address

Tool ID: geocode_address

What It Does: Convert physical addresses to geographic coordinates (latitude/longitude)

Search Nearby Places

Tool ID: search_nearby

What It Does: Find businesses, landmarks, and places near a specific location

Get Place Suggestions

Tool ID: get_place_suggestions

What It Does: Autocomplete and suggest places based on partial input

Common Use Cases for Location Tools:

Address validation and standardization
Local business discovery
Route planning and logistics
Store locator functionality
Geographic data enrichment
Territory mapping

Example Agent Instruction:

Geocode the address "123 Main St, San Francisco, CA".
Search for coffee shops within 1 mile of those coordinates.
Return the top 5 results with names, addresses, and ratings.

Gemini Grounded Maps (3)

All Gemini Grounded Maps tools require no credentials (system-wide API key)

Maps Place Search

Tool ID: gemini_maps_search

Credential Required: No (system-wide API key)

What It Does: AI-powered place discovery using Google Maps' database of 250+ million places worldwide. Returns place recommendations with Google Maps links for restaurants, hotels, attractions, and more.

Common Use Cases:

Find restaurants in a specific area
Discover hotels near landmarks
Search for specific business types
Get place recommendations for travel planning

Example Agent Instruction:

Find the best Italian restaurants in downtown Seattle

Maps Nearby Search

Tool ID: gemini_maps_nearby

Credential Required: No (system-wide API key)

What It Does: Location-aware place search using specific coordinates. Ideal for finding places within walking distance of a location or near a specific address.

Common Use Cases:

Find nearby pharmacies or gas stations
Locate coffee shops near current location
Discover restaurants within walking distance
Find services near a specific address

Example Agent Instruction:

Find coffee shops near coordinates 34.050481, -118.248526

Maps Directions

Tool ID: gemini_maps_directions

Credential Required: No (system-wide API key)

What It Does: AI-generated directions between two locations with estimated time, distance, and key landmarks. Supports driving, walking, transit, and bicycling modes.

Common Use Cases:

Get driving directions between cities
Plan walking routes between landmarks
Find transit options in urban areas
Compare travel modes for route planning

Example Agent Instruction:

Get walking directions from Empire State Building to Central Park

Check Domain Availability

Tool ID: domain_availability

Credential Required: No

What It Does: Check if a domain name is registered or available for registration using the RDAP (Registration Data Access Protocol). Supports 500+ TLDs including .com, .net, .org, .ai, .xyz, .co, .us, and many more. Provides real-time data from authoritative RDAP servers.

Common Use Cases:

Brand name validation before business launch
Finding available domain alternatives for marketing campaigns
Competitive analysis of domain portfolios
Checking domain status before purchase negotiations
Multi-TLD domain availability research

Example Agent Instructions:

Check if techstartup2025.com is available for registration

Is example-ai-tool.ai already taken? If so, suggest 5 similar available domains.

Check the registration status of competitor-website.com and provide details about when it was registered and when it expires.

Parameters:

domain: The full domain name to check (required, e.g., "example.com")
include_details: (Optional) Set to true to get detailed registration information for registered domains (default: false)

Response Format: The tool returns JSON with the domain status:

status: "available", "registered", or "error"
message: Human-readable status description
details: (If requested) Registration date, expiration, nameservers, registrar, DNSSEC status

Supported TLDs (500+):

Generic: .com, .net, .org, .info, .biz
Country-code: .us, .uk, .de, .fr, .jp, .br, .cn, .au, .ca, .in
New gTLDs: .xyz, .ai, .io, .co, .dev, .app, .tech, .online, .site, .store

Note: This tool queries authoritative RDAP servers in real-time, so results are always current. No API key or authentication required - domain registration data is public.

Business Integration Tools

Call API

Tool ID: apicall

Credential Required: Yes (API Key - see API Call Setup)

What It Does: Make authenticated HTTP requests (GET, POST, PUT, DELETE) to any REST API with custom headers and authentication

Common Use Cases:

Integration with custom internal APIs
Third-party service integration not covered by other tools
Webhook triggers
Custom data source connections
Proprietary system automation
Legacy system integration

Example Agent Instruction:

Make a POST request to our internal CRM API at https://api.company.com/contacts.
Create a new contact with these details: [contact info].
Use the credential "Internal CRM Key" for authentication.
Return the created contact ID from the API response.

Automation Tools

Automate Web Browser

Tool ID: browser_automation

Credential Required: Yes (Bearer Token - see Browser Automation Setup)

What It Does: Automated web browser interactions with live viewing capabilities. Navigate websites, fill forms, click elements, extract data, and handle complex web workflows.

Common Use Cases:

Automated form submissions
Web application testing
Data extraction from JavaScript-heavy sites
Login-protected content access
Complex multi-step web workflows
Competitor website monitoring
E-commerce price tracking
Automated data entry

Example Agent Instruction:

Navigate to the company portal at https://portal.company.com.
Fill in the login form with credentials from the secure vault.
Navigate to the Reports section.
Click on "Monthly Sales Report" and download the latest PDF.
Return the download location.

Tool Selection Best Practices

Choosing the Right Tools

Start Simple: Begin with 1-2 tools and expand as needed
Match to Task: Select tools that directly support the agent's objective
Consider Dependencies: Some workflows require multiple tools in sequence
Test Incrementally: Add tools one at a time to verify functionality

Common Tool Combinations

Social Media Manager Agent:

Post to LinkedIn + Instagram tools + YouTube tools
Generate Images (create visuals)
Search Web (research trending topics)
Manage Google Docs (plan content calendar)

Research Agent:

Search Web + Search News (web and news search)
Retrieve Web Page Content (detailed content extraction)
Manage Google Docs (compile findings and reports)

Content Creation Agent:

Search Web (research topics)
Generate Images (create visuals)
Manage Google Docs (write content)
Instagram/LinkedIn tools (publish)

Business Automation Agent:

Call API (internal systems integration)
Manage Google Docs (documentation and reporting)
Automate Web Browser (legacy system workflows)

Customer Service Agent:

Instagram/YouTube comment tools
Search Web (research solutions)
Manage Google Docs (create knowledge base)

Performance Tips

Limit Tools: Each tool adds complexity; only add what's necessary
Credential Setup: Set up all required credentials before testing
Clear Instructions: Specify exactly when and how to use each tool
Error Handling: Include fallback instructions if a tool fails
Rate Limits: Be aware of API rate limits for social media tools

Viewing Tool Outputs

When agents execute tools during workflow runs:

Tool usage appears in the Timeline Panel (left side) with tool-specific badges
Click on a tool entry to view detailed results in the Terminal Panel (right side)
Tool outputs are formatted based on the tool type:
- Search results show snippets and URLs
- Social media tools show post IDs and status
- Image tools display generated/edited images
- API calls show request/response data

Troubleshooting Tools

Verify the tool name matches the list in this reference
Check that you're in the Tools section of agent configuration
Refresh the page and try searching again

Tool Execution Fails

For Credential-Required Tools:

Verify credential is set up and showing "Connected" status (OAuth2) or saved (API Key)
Check that the correct credential is assigned to the tool in agent configuration
Try reconnecting OAuth2 credentials (see Managing Credentials)
Verify your account has proper permissions for the service (e.g., Instagram Business account)

For Non-Credential Tools:

Check that agent instructions are clear about how to use the tool
Verify input parameters are correctly formatted
Review error message in the execution timeline for details

Tool Returns Unexpected Results

Review the full tool output in the Terminal Panel for error details
Check if the service's API has rate limits or restrictions (common with social media)
Verify the agent's instructions match the tool's actual capabilities
Test the tool with a simpler, minimal request first
For OAuth2 tools, ensure tokens haven't expired (they auto-refresh but can fail)

Rate Limiting Issues

Social media tools (Instagram, YouTube, LinkedIn) have API rate limits:

Space out tool calls in your workflow
Use check_publishing_limit before posting to Instagram
Monitor API usage in the service's developer console
Consider implementing delay logic in agent instructions

Managing Credentials - Set up authentication for tools
Creating Agent Workflows - Add tools to agents
Running Agent Workflows - View tool execution in real-time
Editing Agent Workflows - Modify tool configurations