SourceSync.ai MCP server for AI agents

The SourceSync.ai MCP Server implementation provides a standardized interface for AI models to interact with SourceSync.ai's knowledge management platform. This server allows you to manage namespaces, ingest content from various sources, search your knowledge base, and integrate with external services.

Installation Options

Quick Start with npx

# Install and run with your API key
env SOURCESYNC_API_KEY=your_api_key npx -y sourcesyncai-mcp

Installing via Smithery

For Claude Desktop automatic installation:

npx -y @smithery/cli install @pbteja1998/sourcesyncai-mcp --client claude

Configuring with Cursor

To set up SourceSync.ai MCP in Cursor:

Open Cursor Settings
Go to Features > MCP Servers
Click + Add New MCP Server
Enter the following:
- Name: sourcesyncai-mcp (or your preferred name)
- Type: command
- Command: env SOURCESYNCAI_API_KEY=your-api-key npx -y sourcesyncai-mcp

Configuring with Windsurf

Add this to your ./codeium/windsurf/model_config.json:

{
  "mcpServers": {
    "sourcesyncai-mcp": {
      "command": "npx",
      "args": ["-y", "soucesyncai-mcp"],
      "env": {
        "SOURCESYNC_API_KEY": "your_api_key",
        "SOURCESYNC_NAMESPACE_ID": "your_namespace_id",
        "SOURCESYNC_TENANT_ID": "your_tenant_id"
      }
    }
  }
}

Configuring with Claude Desktop

Locate the Claude Desktop configuration file:
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%\Claude\claude_desktop_config.json
- Linux: ~/.config/Claude/claude_desktop_config.json
Edit the configuration file to add the SourceSync.ai MCP server:

{
  "mcpServers": {
    "sourcesyncai-mcp": {
      "command": "npx",
      "args": ["-y", "sourcesyncai-mcp"],
      "env": {
        "SOURCESYNC_API_KEY": "your_api_key",
        "SOURCESYNC_NAMESPACE_ID": "your_namespace_id",
        "SOURCESYNC_TENANT_ID": "your_tenant_id"
      }
    }
  }
}

Save the configuration file and restart Claude Desktop

Configuration

Environment Variables

Required

SOURCESYNC_API_KEY: Your SourceSync.ai API key

Optional

SOURCESYNC_NAMESPACE_ID: Default namespace ID to use
SOURCESYNC_TENANT_ID: Your tenant ID

Basic Configuration Example

export SOURCESYNC_API_KEY=your_api_key
export SOURCESYNC_TENANT_ID=your_tenant_id
export SOURCESYNC_NAMESPACE_ID=your_namespace_id

Using the Tools

Authentication

{
  "name": "validate_api_key",
  "arguments": {}
}

Namespace Management

Create a new namespace:

{
  "name": "create_namespace",
  "arguments": {
    "name": "my-namespace",
    "fileStorageConfig": {
      "provider": "S3_COMPATIBLE",
      "config": {
        "endpoint": "s3.amazonaws.com",
        "accessKey": "your_access_key",
        "secretKey": "your_secret_key",
        "bucket": "your_bucket",
        "region": "us-east-1"
      }
    },
    "vectorStorageConfig": {
      "provider": "PINECONE",
      "config": {
        "apiKey": "your_pinecone_api_key",
        "environment": "your_environment",
        "index": "your_index"
      }
    },
    "embeddingModelConfig": {
      "provider": "OPENAI",
      "config": {
        "apiKey": "your_openai_api_key",
        "model": "text-embedding-3-small"
      }
    },
    "tenantId": "tenant_XXX"
  }
}

List all namespaces:

{
  "name": "list_namespaces",
  "arguments": {
    "tenantId": "tenant_XXX"
  }
}

Get namespace details:

{
  "name": "get_namespace",
  "arguments": {
    "namespaceId": "namespace_XXX",
    "tenantId": "tenant_XXX"
  }
}

Content Ingestion

Ingest text content:

{
  "name": "ingest_text",
  "arguments": {
    "namespaceId": "your_namespace_id",
    "ingestConfig": {
      "source": "TEXT",
      "config": {
        "name": "example-document",
        "text": "This is an example document for ingestion.",
        "metadata": {
          "category": "example",
          "author": "AI Assistant"
        }
      }
    },
    "tenantId": "tenant_XXX"
  }
}

Ingest from URLs:

{
  "name": "ingest_urls",
  "arguments": {
    "namespaceId": "your_namespace_id",
    "ingestConfig": {
      "source": "URLS",
      "config": {
        "urls": ["https://example.com/page1", "https://example.com/page2"],
        "metadata": {
          "source": "web",
          "category": "documentation"
        }
      }
    },
    "tenantId": "tenant_XXX"
  }
}

Ingest from a website:

{
  "name": "ingest_website",
  "arguments": {
    "namespaceId": "your_namespace_id",
    "ingestConfig": {
      "source": "WEBSITE",
      "config": {
        "url": "https://example.com",
        "maxDepth": 3,
        "maxPages": 100,
        "metadata": {
          "source": "website",
          "domain": "example.com"
        }
      }
    },
    "tenantId": "tenant_XXX"
  }
}

Document Management

Retrieve documents:

{
  "name": "getDocuments",
  "arguments": {
    "namespaceId": "namespace_XXX",
    "tenantId": "tenant_XXX",
    "filterConfig": {
      "documentTypes": ["PDF"]
    },
    "includeConfig": {
      "parsedTextFileUrl": true
    }
  }
}

Update document metadata:

{
  "name": "updateDocuments",
  "arguments": {
    "namespaceId": "namespace_XXX",
    "tenantId": "tenant_XXX",
    "documentIds": ["doc_XXX", "doc_YYY"],
    "data": {
      "metadata": {
        "status": "reviewed",
        "category": "technical"
      }
    }
  }
}

Fetch document content:

{
  "name": "fetchUrlContent",
  "arguments": {
    "url": "https://api.sourcesync.ai/v1/documents/doc_XXX/content?format=text",
    "apiKey": "your_api_key",
    "tenantId": "tenant_XXX"
  }
}

Searching Your Knowledge Base

Semantic search:

{
  "name": "semantic_search",
  "arguments": {
    "namespaceId": "your_namespace_id",
    "query": "example document",
    "topK": 5,
    "tenantId": "tenant_XXX"
  }
}

Hybrid search (semantic + keyword):

{
  "name": "hybrid_search",
  "arguments": {
    "namespaceId": "your_namespace_id",
    "query": "example document",
    "topK": 5,
    "tenantId": "tenant_XXX",
    "hybridConfig": {
      "semanticWeight": 0.7,
      "keywordWeight": 0.3
    }
  }
}

Managing External Connections

Create a connection:

{
  "name": "create_connection",
  "arguments": {
    "tenantId": "tenant_XXX",
    "namespaceId": "namespace_XXX",
    "name": "My Connection",
    "connector": "GOOGLE_DRIVE",
    "clientRedirectUrl": "https://your-app.com/callback"
  }
}

List connections:

{
  "name": "list_connections",
  "arguments": {
    "tenantId": "tenant_XXX",
    "namespaceId": "namespace_XXX"
  }
}

Example Prompts

Once configured, you can use prompts like:

"Search my SourceSync knowledge base for information about machine learning."
"Ingest this article into my SourceSync knowledge base: [URL]"
"Create a new namespace in SourceSync for my project documentation."
"List all the documents in my SourceSync namespace."

Troubleshooting

If you encounter connection issues:

Verify all paths in your configuration are absolute paths
Ensure the server has execution permissions
Enable Developer Mode in Claude Desktop and check the MCP Log File
Test the server directly from command line
Restart your AI client after making changes
Verify all environment variables are correctly set

How to install this MCP server

For Claude Code

To add this MCP server to Claude Code, run this command in your terminal:

claude mcp add-json "sourcesyncai-mcp" '{"command":"npx","args":["-y","sourcesyncai-mcp"],"env":{"SOURCESYNC_API_KEY":"your_api_key","SOURCESYNC_NAMESPACE_ID":"your_namespace_id","SOURCESYNC_TENANT_ID":"your_tenant_id"}}'

See the official Claude Code MCP documentation for more details.

For Cursor

There are two ways to add an MCP server to Cursor. The most common way is to add the server globally in the ~/.cursor/mcp.json file so that it is available in all of your projects.

If you only need the server in a single project, you can add it to the project instead by creating or adding it to the .cursor/mcp.json file.

Adding an MCP server to Cursor globally

To add a global MCP server go to Cursor Settings > Tools & Integrations and click "New MCP Server".

When you click that button the ~/.cursor/mcp.json file will be opened and you can add your server like this:

{
    "mcpServers": {
        "sourcesyncai-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "sourcesyncai-mcp"
            ],
            "env": {
                "SOURCESYNC_API_KEY": "your_api_key",
                "SOURCESYNC_NAMESPACE_ID": "your_namespace_id",
                "SOURCESYNC_TENANT_ID": "your_tenant_id"
            }
        }
    }
}

Adding an MCP server to a project

To add an MCP server to a project you can create a new .cursor/mcp.json file or add it to the existing one. This will look exactly the same as the global MCP server example above.

How to use the MCP server

Once the server is installed, you might need to head back to Settings > MCP and click the refresh button.

The Cursor agent will then be able to see the available tools the added MCP server has available and will call them when it needs to.

You can also explicitly ask the agent to use the tool by mentioning the tool name and describing what the function does.

For Claude Desktop

To add this MCP server to Claude Desktop:

1. Find your configuration file:

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

2. Add this to your configuration file:

{
    "mcpServers": {
        "sourcesyncai-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "sourcesyncai-mcp"
            ],
            "env": {
                "SOURCESYNC_API_KEY": "your_api_key",
                "SOURCESYNC_NAMESPACE_ID": "your_namespace_id",
                "SOURCESYNC_TENANT_ID": "your_tenant_id"
            }
        }
    }
}

3. Restart Claude Desktop for the changes to take effect