Skip to main content
AgentOS includes 25 pre-configured MCP (Model Context Protocol) integrations that connect agents to external services via standardized stdio-based servers. Integrations enable agents to interact with GitHub repos, Slack workspaces, Jira projects, databases, cloud APIs, and more — without custom tool code.

​
Quick Start

# List available integrations
agentos integrations

# Add an integration
agentos add github --key $GITHUB_TOKEN

# Add with environment variables
export SLACK_BOT_TOKEN=xoxb-...
agentos add slack

# Test integration
agentos integration test github

# Remove integration
agentos remove github

​
How MCP Works

MCP integrations run as stdio-based child processes that expose tools to agents: 
┌─────────────┐
│   Agent     │
│  (Rust/TS)  │
└──────┬──────┘
       │
       │ MCP Protocol (JSON-RPC over stdio)
       │
┌──────▼──────────────────────────────────┐
│  @modelcontextprotocol/server-github    │
│  (Node.js subprocess)                   │
└──────┬──────────────────────────────────┘
       │
       │ GitHub REST API
       │
┌──────▼──────┐
│   GitHub    │
└─────────────┘
Agents send tool calls via JSON-RPC, the MCP server executes the operation, and returns results.

​
Developer Tools

Integrations for source control, project management, and CI/CD.

GitHub

Repository management — access repos, issues, pull requests, and GitHub Actions.
agentos add github --key $GITHUB_TOKEN
Capabilities: Create issues, comment on PRs, trigger workflows, search codeOAuth: Supported (scopes: repo, read:org)

GitLab

GitLab project management — manage repos, merge requests, pipelines, and issues.
export GITLAB_PERSONAL_ACCESS_TOKEN=glpat-...
export GITLAB_URL=https://gitlab.com
agentos add gitlab
Capabilities: Create MRs, approve pipelines, manage labels, search projects

Bitbucket

Bitbucket repository access — manage repos, pull requests, and pipelines.
export BITBUCKET_USERNAME=user
export BITBUCKET_APP_PASSWORD=...
agentos add bitbucket
Capabilities: Create PRs, manage branches, trigger pipelines

Jira

Issue tracking and sprint management — create/update issues, manage sprints, query boards.
export JIRA_URL=https://your-domain.atlassian.net
export JIRA_EMAIL=user@example.com
export JIRA_API_TOKEN=...
agentos add jira
Capabilities: Create/update issues, transition status, manage sprints

Linear

Modern issue tracking — create issues, update status, manage projects.
agentos add linear --key $LINEAR_API_KEY
Capabilities: Create issues, update status, assign to team members

Sentry

Error monitoring — query errors, update issue status, create releases.
export SENTRY_AUTH_TOKEN=...
export SENTRY_ORG=my-org
agentos add sentry
Capabilities: Query errors, resolve issues, track releases

​
Communication Platforms

Integrations for team collaboration and messaging.

Slack

Workspace messaging — send messages, read channels, manage conversations.
export SLACK_BOT_TOKEN=xoxb-...
agentos add slack
Capabilities: Send messages, list channels, read conversations, upload filesOAuth: Supported (scopes: channels:read, chat:write, users:read)

Discord

Discord bot integration — send messages, read channels, manage roles.
export DISCORD_BOT_TOKEN=...
agentos add discord-mcp
Capabilities: Send messages, manage channels, read message history

Microsoft Teams

Teams messaging — send messages, read conversations, manage channels.
export TEAMS_TENANT_ID=...
export TEAMS_CLIENT_ID=...
export TEAMS_CLIENT_SECRET=...
agentos add teams-mcp
Capabilities: Send messages, list teams, read channels

​
Productivity & Storage

Integrations for documents, calendars, and file storage.

Notion

Workspace knowledge base — read/write pages, query databases, manage blocks.
export NOTION_API_KEY=secret_...
agentos add notion
Capabilities: Create pages, update databases, search workspace

Google Drive

File storage and collaboration — list files, upload/download, manage permissions.
export GOOGLE_DRIVE_CREDENTIALS='{...}'
agentos add google-drive
Capabilities: List files, upload/download, share files, manage folders

Gmail

Email management — send emails, read threads, manage labels.
export GMAIL_CREDENTIALS='{...}'
agentos add gmail
Capabilities: Send emails, read messages, manage labels, search threads

Google Calendar

Calendar management — create events, list schedules, manage attendees.
export GOOGLE_CALENDAR_CREDENTIALS='{...}'
agentos add google-calendar
Capabilities: Create events, list calendars, update attendees

Dropbox

File storage — upload/download files, manage folders, share links.
export DROPBOX_ACCESS_TOKEN=...
agentos add dropbox
Capabilities: Upload/download, list files, create shared links

Todoist

Task management — create tasks, manage projects, track completion.
export TODOIST_API_TOKEN=...
agentos add todoist
Capabilities: Create/update tasks, manage projects, set priorities

​
Cloud Providers

Integrations for AWS, Azure, and GCP infrastructure management.

AWS

Amazon Web Services — manage EC2, S3, Lambda, and other AWS services.
export AWS_ACCESS_KEY_ID=...
export AWS_SECRET_ACCESS_KEY=...
export AWS_REGION=us-east-1
agentos add aws
Capabilities: EC2 management, S3 operations, Lambda invocation, CloudWatch queries

Azure

Microsoft Azure — manage VMs, storage, functions, and Azure resources.
export AZURE_SUBSCRIPTION_ID=...
export AZURE_TENANT_ID=...
export AZURE_CLIENT_ID=...
export AZURE_CLIENT_SECRET=...
agentos add azure-mcp
Capabilities: Resource management, VM operations, storage access

GCP

Google Cloud Platform — manage Compute Engine, Cloud Storage, Cloud Functions.
export GCP_PROJECT_ID=my-project
export GCP_CREDENTIALS='{...}'
agentos add gcp-mcp
Capabilities: VM management, storage operations, function deployment

​
Databases

Integrations for SQL and NoSQL database access.

PostgreSQL

PostgreSQL database — query and manage PostgreSQL databases.
export POSTGRES_CONNECTION_STRING="postgresql://user:pass@host:5432/db"
agentos add postgresql
Capabilities: Execute queries, list tables, describe schema

MongoDB

MongoDB database — query documents, manage collections, run aggregations.
export MONGODB_URI="mongodb://user:pass@host:27017/db"
agentos add mongodb
Capabilities: Query documents, insert/update, run aggregations

Redis

Redis cache — get/set keys, manage data structures, run commands.
export REDIS_URL="redis://host:6379"
agentos add redis
Capabilities: Get/set keys, list operations, pub/sub

SQLite

SQLite database — query local SQLite databases.
export SQLITE_DB_PATH="/path/to/database.db"
agentos add sqlite-mcp
Capabilities: Execute queries, list tables, describe schema

Elasticsearch

Search and analytics — query indices, manage documents, run aggregations.
export ELASTICSEARCH_URL="https://localhost:9200"
export ELASTICSEARCH_API_KEY=...
agentos add elasticsearch
Capabilities: Search indices, index documents, run aggregations

​
Search Engines

Integrations for web search and knowledge retrieval.

Brave Search

Privacy-focused search — web search with Brave Search API.
agentos add brave-search --key $BRAVE_API_KEY
Capabilities: Web search, news search, image search

Exa Search

AI-powered search — semantic search with Exa (formerly Metaphor).
agentos add exa-search --key $EXA_API_KEY
Capabilities: Semantic web search, content extraction, similarity search

​
Integration Configuration

Integrations are defined in TOML format: 
[integration]
id = "github"
name = "GitHub"
description = "Access GitHub repositories, issues, pull requests, and actions"
category = "developer"
transport = "stdio"
command = "npx"
args = ["-y", "@modelcontextprotocol/server-github"]

[integration.env]
GITHUB_PERSONAL_ACCESS_TOKEN = { required = true, description = "GitHub personal access token with repo scope" }

[integration.oauth]
enabled = true
provider = "github"
scopes = ["repo", "read:org"]

​
Adding Integrations

# Via command line flag
agentos add github --key $GITHUB_TOKEN

# Via interactive prompt
agentos add github
# Prompt: Enter GITHUB_PERSONAL_ACCESS_TOKEN: █

# Set environment variables first
export SLACK_BOT_TOKEN=xoxb-...
export SLACK_TEAM_ID=T123456

# Add integration
agentos add slack

# Start OAuth flow (opens browser)
agentos add github --oauth

# Agent will redirect to auth page
# After approval, token is stored securely

# Create custom integration
cat > my-integration.toml <<EOF
[integration]
id = "custom-api"
name = "Custom API"
transport = "stdio"
command = "node"
args = ["./custom-mcp-server.js"]

[integration.env]
API_KEY = { required = true }
EOF

# Install integration
agentos integration install my-integration.toml --key $API_KEY

​
Testing Integrations

# Test connection and list available tools
agentos integration test github

# Output:
# ✓ Connected to GitHub MCP server
# ✓ Available tools:
#   - github_create_issue
#   - github_list_repos
#   - github_search_code
#   ...

# Test with specific tool invocation
agentos integration test github --tool github_list_repos

​
Managing Integrations

agentos integration list
agentos integration list --category developer
agentos integration list --format json

agentos integration describe github

# Output shows:
# - Available tools
# - Required environment variables
# - OAuth configuration
# - Connection status

agentos integration update github --key $NEW_GITHUB_TOKEN

agentos remove github
agentos integration remove github --confirm

​
Agent Integration Access

Control which integrations an agent can use: 
[agent.capabilities]
# Grant access to all GitHub tools
tools = ["github::*"]

# Grant access to specific tools only
tools = [
  "github::github_create_issue",
  "github::github_list_repos"
]

# Grant access to multiple integrations
tools = [
  "github::*",
  "slack::*",
  "jira::*"
]

​
Security Best Practices

Credential Storage

All API keys and tokens are stored in the encrypted vault using AES-256-GCM with PBKDF2 key derivation.

Least Privilege

Grant agents access only to specific integration tools they need, not wildcard access.

Token Rotation

Regularly rotate API tokens and update integrations using agentos integration update.

OAuth Preferred

Use OAuth flows when available for automatic token refresh and scope management.

Environment Isolation

Use different credentials for development, staging, and production realms.

​
Creating Custom Integrations

Build custom MCP servers for proprietary APIs: 
import { Server } from '@modelcontextprotocol/sdk/server/index.js';
import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';

const server = new Server(
  {
    name: 'custom-api-server',
    version: '1.0.0',
  },
  {
    capabilities: {
      tools: {},
    },
  }
);

// Register tools
server.setRequestHandler('tools/list', async () => ({
  tools: [
    {
      name: 'custom_api_call',
      description: 'Call custom API endpoint',
      inputSchema: {
        type: 'object',
        properties: {
          endpoint: { type: 'string' },
          method: { type: 'string', enum: ['GET', 'POST'] }
        },
        required: ['endpoint']
      }
    }
  ]
}));

server.setRequestHandler('tools/call', async (request) => {
  if (request.params.name === 'custom_api_call') {
    // Implement API call logic
    const result = await fetch(...);
    return { content: [{ type: 'text', text: JSON.stringify(result) }] };
  }
});

const transport = new StdioServerTransport();
await server.connect(transport);

​
Troubleshooting

# Check integration status
agentos integration status github

# View detailed logs
agentos logs --filter integration=github --lines 50

# Test with verbose output
agentos integration test github --verbose

# Verify agent has tool access
agentos agent describe my-agent | grep capabilities

# Grant integration access
# Edit agent.toml:
[agent.capabilities]
tools = ["github::*"]

# Reload agent
agentos agent reload my-agent
Most integrations respect rate limits. Check provider documentation:
  • GitHub: 5,000 requests/hour (authenticated)
  • Slack: Tier-based limits
  • Jira: 5 requests/second per user
Configure rate limiting in agent capabilities:
[agent.resources]
max_requests_per_hour = 1000

​
Next Steps

Agent Templates

Configure agents to use integrations

Tool Profiles

Filter integration tools by profile

Vault

Secure credential storage

MCP Specification

Learn the MCP protocol specification

Build docs developers (and LLMs) love

Get started for freeTalk to us