Seclai MCP Server

Connect AI-powered coding tools to Seclai using the Model Context Protocol. Manage your agents, knowledge bases, content sources, memory banks, evaluations, solutions, governance, alerts, models, and more directly from your editor or terminal.

Quick Start

Endpoint: https://mcp.seclai.com Transport: Streamable HTTP Auth: X-API-Key header or Authorization: Bearer <token> (OAuth)

You need a Seclai account with API access. Authenticate with either:

1. API key — create one at seclai.com → Account Settings → API Keys.
2. OAuth Bearer token — use an OAuth2 access token from the Seclai SSO flow.

To target a specific organization, include the X-Account-Id header.

Claude Desktop

Add to your config file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "seclai": {
      "type": "streamable-http",
      "url": "https://mcp.seclai.com",
      "headers": {
        "X-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

Or with OAuth and org targeting:

{
  "mcpServers": {
    "seclai": {
      "type": "streamable-http",
      "url": "https://mcp.seclai.com",
      "headers": {
        "Authorization": "Bearer YOUR_ACCESS_TOKEN",
        "X-Account-Id": "YOUR_ACCOUNT_ID"
      }
    }
  }
}

Restart Claude Desktop after saving.

Claude Code (CLI)

claude mcp add seclai \
  --transport streamable-http \
  "https://mcp.seclai.com" \
  --header "X-API-Key: YOUR_API_KEY"

Or copy examples/claude-code.json to .mcp.json in your project root.

Cursor

Copy examples/cursor.json to .cursor/mcp.json in your project root.

Or add manually: Settings → MCP → Add new MCP server → set type to streamable-http and URL to https://mcp.seclai.com.

Windsurf

Copy examples/windsurf.json to ~/.codeium/windsurf/mcp_config.json.

Other Clients

Any client supporting Streamable HTTP MCP transport works. Configure:

Setting	Value
URL	https://mcp.seclai.com
Transport	Streamable HTTP
Auth (API key)	X-API-Key: YOUR_API_KEY
Auth (OAuth)	Authorization: Bearer YOUR_ACCESS_TOKEN
Org targeting	X-Account-Id: YOUR_ACCOUNT_ID (optional)

Available Tools

Agents

Tool	Description
list_agents	List all agents in your account with pagination
get_agent	Get an agent's metadata (name, description, trigger type)
get_agent_definition	Get the full agent definition including steps and change_id
create_agent	Create a new agent with an optional template
update_agent	Update an agent's name and/or description
update_agent_definition	Update an agent's definition with optimistic locking
delete_agent	Delete an agent (cannot be undone)
export_agent	Export an agent's portable JSON snapshot

Agent Runs

Tool	Description
run_agent	Start an agent run
get_agent_run_status	Get the status and result of an agent run
list_agent_runs	List runs for an agent with optional status filter

Agent AI Assistant

Tool	Description
generate_agent_steps	Auto-generate agent steps from a natural-language description
generate_step_config	Generate configuration for a specific step type
get_ai_conversation_history	Get the AI assistant conversation history for an agent
mark_ai_suggestion	Accept or decline an AI-generated suggestion

Evaluations

Tool	Description
list_evaluation_criteria	List evaluation criteria for an agent
get_evaluation_criteria	Get details of a specific evaluation criteria
create_evaluation_criteria	Create a new evaluation criteria
update_evaluation_criteria	Update an existing evaluation criteria
delete_evaluation_criteria	Delete an evaluation criteria
get_evaluation_summary	Get summary statistics for an evaluation criteria
get_non_manual_evaluation_summary	Get summary of non-manual evaluations for an agent
list_evaluation_results	List results for an evaluation criteria
list_agent_evaluation_results	List all evaluation results for an agent
list_run_evaluation_results	List evaluation results for a specific run
create_evaluation_result	Create a manual evaluation result
run_evaluation	Run automated evaluation on a criteria
test_draft_evaluation	Test an evaluation criteria without persisting
opt_evaluation_into_review	Move an evaluation result into the review queue

Knowledge Bases

Tool	Description
list_knowledge_bases	List knowledge bases in your account with pagination
get_knowledge_base	Get a knowledge base's details including its linked sources
create_knowledge_base	Create a new knowledge base with at least one source
update_knowledge_base	Update a knowledge base's name, description, or sources
delete_knowledge_base	Delete a knowledge base (fails if referenced by agents)
generate_kb_plan	AI-generate a knowledge base configuration plan

Knowledge Base Chat

Tool	Description
chat_with_knowledge_base	Chat with a knowledge base using natural language
list_kb_conversations	List conversations for a knowledge base
load_kb_chat_messages	Load messages for a knowledge base conversation
rename_kb_conversation	Rename a knowledge base conversation
delete_kb_conversation	Delete a knowledge base conversation

Content Sources

Tool	Description
list_sources	List all content sources in your account with pagination
get_source	Get detailed information about a content source
create_source	Create a new content source
update_source	Update a source's name, polling interval, or retention
delete_source	Delete a content source
get_source_content_text	Get the text content of a source item
list_account_source_content	List all source content in the account
list_source_pulls	List pull (sync) operations for a source
get_source_pull_errors	Get errors from a source pull operation
generate_source_plan	AI-generate a source configuration plan

Source Exports

Tool	Description
list_source_exports	List exports for a source
get_source_export	Get details of a source export
create_source_export	Create a new source export
cancel_source_export	Cancel a running source export
download_source_export	Download a completed source export
estimate_source_export	Estimate the size/cost of a source export

Source Embedding Migrations

Tool	Description
get_source_embedding_migration	Get status of an embedding migration
start_source_embedding_migration	Start a new embedding migration
cancel_source_embedding_migration	Cancel a running embedding migration

Memory Banks

Tool	Description
list_memory_banks	List memory banks with pagination
get_memory_bank	Get a memory bank's details
create_memory_bank	Create a new memory bank (conversation or general)
update_memory_bank	Update a memory bank's name or configuration
delete_memory_bank	Delete a memory bank
get_memory_bank_stats	Get usage statistics for a memory bank
get_agents_using_memory_bank	List agents that reference a memory bank
compact_memory_bank_now	Trigger compaction of a memory bank
delete_memory_bank_source	Delete the source backing a memory bank
list_memory_bank_templates	List available memory bank templates
test_compaction_prompt	Test a compaction prompt without applying

Memory Bank AI

Tool	Description
generate_memory_bank_config	AI-generate a memory bank configuration
get_memory_bank_ai_conversation	Get the last AI conversation for a memory bank
accept_memory_bank_suggestion	Accept an AI-generated memory bank suggestion

Solutions

Tool	Description
list_solutions	List solutions with pagination
get_solution	Get a solution's details
create_solution	Create a new solution
update_solution	Update a solution's name or description
delete_solution	Delete a solution
link_solution_resources	Link agents, KBs, or sources to a solution
unlink_solution_resources	Unlink resources from a solution
generate_solution_plan	AI-generate a solution configuration plan
accept_solution_plan	Accept an AI-generated solution plan
decline_solution_plan	Decline an AI-generated solution plan

Governance

Tool	Description
get_governance_settings	Get current governance settings
update_governance_settings	Enable/disable governance or update settings
list_governance_settings	List all governance settings
list_governance_policies	List all governance policies
get_governance_policy	Get a specific governance policy
create_governance_policy	Create a new governance policy
update_governance_policy	Update a governance policy
list_governance_policy_documents	Browse available sample policy documents
get_governance_policy_document	Get a specific sample policy document
get_governance_policy_usage	Get usage stats for a policy
list_governance_policy_changes	List change history for a policy
list_governance_evaluations	List governance evaluations (filter by verdict)
resolve_governance_evaluation	Resolve a flagged governance evaluation
bulk_resolve_governance_evaluations	Resolve multiple evaluations at once
test_draft_governance_policy	Test a policy draft without persisting
test_governance_policy	Test a policy and persist the result
set_policy_knowledge_bases	Link knowledge bases to a policy for RAG evidence
list_policy_knowledge_bases	List knowledge bases linked to a policy
get_circular_knowledge_bases	Check for circular KB references before linking
get_governance_stats	Get aggregate governance metrics
get_governance_usage	Get governance usage details
get_governance_credit_estimates	Estimate governance credit costs
list_governance_audit_trail	List governance audit trail entries
list_governance_conversations	List governance AI conversations
generate_governance_plan	AI-generate a governance plan from natural language
accept_governance_plan	Accept an AI-generated governance plan
decline_governance_plan	Decline an AI-generated governance plan

Alerts

Tool	Description
list_alerts	List alerts with optional status/severity filters
get_alert	Get details of a specific alert
change_alert_status	Change an alert's status (e.g. resolve)
add_alert_comment	Add a comment to an alert
list_alert_configs	List alert configurations
get_alert_config	Get a specific alert configuration
create_alert_config	Create a new alert configuration
update_alert_config	Update an alert configuration
delete_alert_config	Delete an alert configuration
list_organization_alert_preferences	List org-level alert preferences
update_organization_alert_preference	Update an org-level alert preference

Models

Tool	Description
list_models	List models grouped by provider with optional filters
get_model	Get full details for a specific model
get_model_recommendations	Get recommendations for a model
list_model_alerts	List model-related alerts
dismiss_model_alert	Dismiss a model alert
dismiss_all_model_alerts	Dismiss all model alerts

Playground Experiments

Tool	Description
list_experiments	List model playground experiments
get_experiment	Get a specific experiment
run_experiment	Run a model playground experiment
cancel_experiment	Cancel a running experiment

Account & Organization

Tool	Description
get_account_credit_usage	Get credit usage for the account
get_account_llm_calls_summary	Get LLM call summary for the account
list_organizations	List organizations the user belongs to
switch_organization	Switch to a different organization

Resource Exports

Tool	Description
list_resource_exports	List resource exports
get_resource_export	Get a specific resource export
create_resource_export	Create a resource export
cancel_resource_export	Cancel a resource export
download_resource_export	Download a completed resource export

Transfers

Tool	Description
list_transfer_targets	List available transfer targets
preview_transfer	Preview a resource transfer between accounts
execute_transfer	Execute a resource transfer

Search

Tool	Description
search	Search across all resource types in the account

Resources

Resource	URI	Description
Agent Definition Schema	seclai://schema/agent-definition	Full schema reference for agent definitions
String Substitutions	seclai://schema/string-substitutions	All supported string substitution expressions

Usage Examples

Once connected, interact with Seclai through natural language:

"Show me all my Seclai agents"

"Create a new agent called 'Daily News Digest' with a schedule trigger and the summarizer template"

"Add a retrieval step before the display step in my Daily News Digest agent"

"Create a knowledge base called 'Podcast Archive' using my podcast sources"

"Show me all my content sources and change the news feed to poll hourly"

Agent Templates

When creating agents, specify a template for a pre-configured starting point:

Template	Description
blank	Empty agent with no steps
retrieval_example	Demonstrates knowledge base retrieval
simple_qa	Basic question-answering agent
summarizer	Summarizes content from sources
json_extractor	Extracts structured data from content
content_change_notifier	Monitors sources for changes and notifies
scheduled_report	Generates reports on a schedule
webhook_pipeline	Processes incoming webhook data

Rate Limits

MCP calls are rate-limited per account based on your plan:

Plan	Calls / Minute
Free	No MCP access
Starter	0
Pro	30
Team	75
Enterprise	300

Exceeded calls return a retry_after value. Most AI assistants handle this automatically.

Troubleshooting

Error	Fix
Invalid API key	Verify key, check account standing, confirm API access on plan
MCP requires a user-scoped API key	Re-create your key — new keys are user-scoped automatically
Rate limit exceeded	Wait the indicated seconds, or upgrade your plan
Tools not appearing	Restart client, verify URL and streamable-http transport
Missing X-API-Key header	Check header config in your MCP client settings
Conflict on definition update	Retry — your assistant will re-read and re-apply

Links

• Full MCP Documentation
• API Keys
• Agent Concepts
• Agent Steps Reference
• REST API
• seclai.com

License

MIT