Tools

Tools are the universal vocabulary for external capabilities that AI agents can use. Hubify provides intelligent integration detection and management for OAuth, MCP, API keys, and webhooks.

Tool Categories

Type	Description	Examples
OAuth	Third-party service connections	GitHub, Slack, Linear, Notion
MCP	Model Context Protocol servers	File systems, databases, custom servers
API Keys	Service authentication	OpenAI, Anthropic, Stripe, AWS
Webhooks	Event-driven integrations	Custom endpoints, Zapier

Listing Tools

View All Tools

hubify tool list

Output:

Available Tools (156 total)

  OAuth Integrations:
    github          Code hosting and collaboration
    slack           Team communication
    linear          Issue tracking
    notion          Documentation and wikis

  MCP Servers:
    filesystem      Local file access
    postgres        PostgreSQL database
    redis           Redis cache

  API Services:
    openai          GPT models
    anthropic       Claude models
    stripe          Payments

View Tool Details

hubify tool info github

Output:

github

  Type:        OAuth
  Description: Code hosting, PRs, issues, and collaboration

  Required Scopes:
    - repo (Full repository access)
    - read:user (Read user profile)

  Capabilities:
    - Create and manage repositories
    - Open and review pull requests
    - Create and manage issues
    - Access organization data

  Skills Using This Tool:
    - github-pr-review (89% confidence)
    - github-issue-triage (85% confidence)
    - github-actions-setup (82% confidence)

Integration Detection

Hubify automatically detects which integrations are available:

hubify tool integrations

Output:

Integration Status

  ✓ GitHub (oauth)
    Status: Connected
    Scopes: repo, read:user

  ✓ OpenAI (api_key)
    Status: Configured
    Env: OPENAI_API_KEY

  ○ Slack (oauth)
    Status: Not connected
    Action: Run `hubify connect slack`

  ○ Linear (oauth)
    Status: Not connected
    Action: Run `hubify connect linear`

Connecting Tools

OAuth Connections

hubify connect github

This opens a browser for OAuth authorization:

Opening browser for GitHub authorization...

Requested scopes:
  - repo: Full repository access
  - read:user: Read user profile

Press Enter to continue or Ctrl+C to cancel...

API Key Configuration

hubify configure openai

Or set via environment:

export OPENAI_API_KEY=sk-...

MCP Servers

hubify mcp add filesystem --path /project

Tool Requirements in Skills

Skills can declare tool requirements:

name: github-pr-review
tools:
  required:
    - github
  optional:
    - slack  # For notifications

When installing a skill, Hubify checks tool availability:

hubify install github-pr-review

Output:

Installing github-pr-review...

Tool Requirements:
  ✓ github (connected)
  ○ slack (optional, not connected)

Install anyway? (y/n)

Tool Capabilities

Each tool exposes specific capabilities:

GitHub

Capability	Description
repo:read	Read repository content
repo:write	Push commits, create branches
pr:read	View pull requests
pr:write	Create/update pull requests
issues:read	View issues
issues:write	Create/update issues

Slack

Capability	Description
message:send	Send messages to channels
message:read	Read channel history
channel:join	Join public channels
user:read	Read user profiles

OpenAI

Capability	Description
completion	Text completions
embedding	Vector embeddings
image	Image generation
audio	Speech to text

MCP Integration

Hubify works with Model Context Protocol servers:

List MCP Servers

hubify mcp list

Add MCP Server

# Local filesystem
hubify mcp add filesystem --path /project

# PostgreSQL
hubify mcp add postgres --connection "postgresql://..."

# Custom server
hubify mcp add custom --url "http://localhost:3000/mcp"

Remove MCP Server

hubify mcp remove filesystem

Tool Composition

Skills can combine multiple tools:

name: full-stack-deploy
tools:
  required:
    - github      # Source code
    - vercel      # Deployment
  optional:
    - slack       # Notifications
    - linear      # Issue updates

Security

Permission Model

• Read-only by default: Tools start with read permissions
• Explicit escalation: Write permissions require confirmation
• Scoped access: Only requested capabilities are granted
• Revocable: Connections can be removed anytime

Viewing Active Connections

hubify tool connections

Revoking Access

hubify disconnect github

Next Steps