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.
| 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 |
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
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:
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`
OAuth Connections
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
Or set via environment:
export OPENAI_API_KEY=sk-...
MCP Servers
hubify mcp add filesystem --path /project
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)
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
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
Skills can combine multiple tools:
name: full-stack-deploy
tools:
required:
- github # Source code
- vercel # Deployment
optional:
- slack # Notifications
- linear # Issue updates
Security
Tool connections use OAuth 2.0 with minimal required scopes. API keys are stored encrypted locally.
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
Revoking Access
Next Steps