@seven.io/mcp 1.0.3

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,295 @@
+# MCP Seven
+
+Model Context Protocol (MCP) server for the [seven.io](https://www.seven.io) API. This server provides comprehensive access to seven.io's SMS, voice, RCS messaging, and account management services.
+
+## Features
+
+### Messaging
+- **SMS**: Send and manage SMS messages
+- **RCS**: Send Rich Communication Services messages with media and suggestions
+- **Voice**: Send text-to-speech voice calls
+
+### Account Management
+- **Balance**: Check account balance
+- **Pricing**: Get pricing information by country
+- **Analytics**: View account statistics
+
+### Lookup Services
+- **Format Validation**: Validate phone number formats
+- **HLR**: Home Location Register lookups (network info, roaming status)
+- **MNP**: Mobile Number Portability lookups (carrier information)
+- **CNAM**: Caller ID name lookups
+- **RCS Capabilities**: Check if a number supports RCS
+
+### Contact Management
+- **Contacts**: Full CRUD operations for contacts
+- **Groups**: Manage contact groups
+
+### Phone Numbers
+- Browse, purchase, and manage phone numbers
+
+### Advanced Features
+- **Webhooks**: Register webhooks for events
+- **Subaccounts**: Create and manage subaccounts
+- **Status & Logbook**: Track message delivery and view history
+
+## Installation
+
+```bash
+npm install -g @seven.io/seven-mcp
+```
+
+## Authentication
+
+This MCP server supports two authentication methods:
+
+### Option 1: OAuth 2.0 with PKCE (Recommended)
+
+OAuth provides better security with automatic token refresh and fine-grained scopes.
+
+1. **Login via CLI**:
+```bash
+npx @seven.io/mcp login
+```
+
+This will:
+- Open your browser to seven.io OAuth authorization
+- Request necessary permissions (SMS, Voice, RCS, etc.)
+- Store tokens securely in your system keychain
+- Auto-refresh tokens when they expire
+
+**CLI Commands**:
+```bash
+# Login with OAuth
+npx @seven.io/mcp login
+
+# Check authentication status
+npx @seven.io/mcp status
+
+# Logout (remove stored tokens)
+npx @seven.io/mcp logout
+```
+
+### Option 2: API Key (Legacy)
+
+For backwards compatibility, you can still use an API key:
+
+```bash
+export SEVEN_API_KEY="your-api-key"
+```
+
+Get your API key from the [seven.io dashboard](https://app.seven.io).
+
+### Priority
+
+If both authentication methods are configured, OAuth takes priority.
+
+## Usage with Claude Desktop
+
+Add this to your Claude Desktop configuration file:
+
+**MacOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
+**Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
+
+**With OAuth (recommended)**:
+```json
+{
+  "mcpServers": {
+    "seven": {
+      "command": "node",
+      "args": ["/absolute/path/to/mcp-seven/dist/index.js"]
+    }
+  }
+}
+```
+
+**With API Key**:
+```json
+{
+  "mcpServers": {
+    "seven": {
+      "command": "node",
+      "args": ["/absolute/path/to/mcp-seven/dist/index.js"],
+      "env": {
+        "SEVEN_API_KEY": "your-api-key"
+      }
+    }
+  }
+}
+```
+
+**With Debug Logging**:
+To enable request/response logging for debugging, add the `SEVEN_LOG_FILE` environment variable:
+```json
+{
+  "mcpServers": {
+    "seven": {
+      "command": "node",
+      "args": ["/absolute/path/to/mcp-seven/dist/index.js"],
+      "env": {
+        "SEVEN_API_KEY": "your-api-key",
+        "SEVEN_LOG_FILE": "/tmp/mcp-seven-debug.log"
+      }
+    }
+  }
+}
+```
+
+Then monitor the log file:
+```bash
+tail -f /tmp/mcp-seven-debug.log
+```
+
+**Note**: If using OAuth, run `npx @seven.io/mcp login` before starting Claude Desktop.
+
+## Available Tools
+
+### Messaging Tools
+- `send_sms` - Send SMS messages
+- `delete_sms` - Delete scheduled SMS
+- `send_rcs` - Send RCS messages
+- `delete_rcs` - Delete RCS messages
+- `rcs_events` - Handle RCS events
+- `send_voice` - Send voice calls
+- `hangup_voice` - End active voice calls
+
+### Account Tools
+- `get_balance` - Check account balance
+- `get_pricing` - Get pricing information
+- `get_analytics` - View account statistics
+
+### Lookup Tools
+- `lookup_format` - Validate phone number format
+- `lookup_hlr` - Home Location Register lookup
+- `lookup_mnp` - Mobile Number Portability lookup
+- `lookup_cnam` - Caller ID name lookup
+- `lookup_rcs` - Check RCS capabilities
+
+### Status & Logbook Tools
+- `get_status` - Check message delivery status
+- `get_logbook_sent` - View sent messages
+- `get_logbook_received` - View received SMS
+- `get_logbook_voice` - View voice call history
+
+### Phone Numbers Tools
+- `get_available_numbers` - List available numbers
+- `order_number` - Purchase a phone number
+- `get_active_numbers` - List active numbers
+- `get_number` - Get number details
+- `update_number` - Update number configuration
+- `delete_number` - Cancel/delete number
+
+### Contact Tools
+- `list_contacts` - List all contacts
+- `create_contact` - Create new contact
+- `get_contact` - Get contact by ID
+- `update_contact` - Update contact
+- `delete_contact` - Delete contact
+
+### Group Tools
+- `list_groups` - List all groups
+- `create_group` - Create new group
+- `get_group` - Get group by ID
+- `update_group` - Update group
+- `delete_group` - Delete group
+
+### Subaccount Tools
+- `list_subaccounts` - List all subaccounts
+- `create_subaccount` - Create new subaccount
+- `update_subaccount` - Update subaccount settings
+- `transfer_credits` - Transfer credits to subaccount
+- `delete_subaccount` - Delete subaccount
+
+### Webhook Tools
+- `list_webhooks` - List registered webhooks
+- `create_webhook` - Register new webhook
+- `delete_webhook` - Delete webhook
+
+### Sender Tools
+- `validate_sender` - Validate sender identifiers
+
+## Example Usage
+
+Once configured, you can use the tools in Claude:
+
+```
+Send an SMS to +1234567890 saying "Hello from seven.io!"
+```
+
+```
+Check my account balance
+```
+
+```
+Look up the carrier information for phone number +1234567890
+```
+
+## Development
+
+### Watch mode
+```bash
+npm run watch
+```
+
+### Build
+```bash
+npm run build
+```
+
+### Testing
+
+Run the comprehensive test suite:
+
+```bash
+npm test
+```
+
+Run tests in watch mode:
+```bash
+npm run test:watch
+```
+
+Generate coverage report:
+```bash
+npm run test:coverage
+```
+
+#### Test Coverage
+
+The test suite includes:
+- **Unit tests** for all API client methods
+- **Tool tests** for all 40+ MCP tools covering:
+  - RCS messaging (3 tools)
+  - SMS messaging (2 tools)
+  - Voice calls (2 tools)
+  - Account management (3 tools)
+  - Lookup services (5 tools)
+  - Status & Logbook (4 tools)
+  - Phone number management (6 tools)
+  - Contact management (5 tools)
+  - Group management (5 tools)
+  - Subaccount management (5 tools)
+  - Webhook management (3 tools)
+  - Sender validation (1 tool)
+- **Integration tests** verifying all tools export correctly and have valid schemas
+- **Endpoint validation tests** that verify API endpoint paths are correct (requires SEVEN_API_KEY)
+
+Coverage target: 80% for branches, functions, lines, and statements.
+
+#### Endpoint Validation
+
+To run endpoint validation tests that verify the API paths are correct:
+
+```bash
+SEVEN_API_KEY=your-api-key npm test
+```
+
+These integration tests ensure that endpoints match the seven.io API documentation and will catch issues like incorrect paths (e.g., using `/logbook/received` instead of `/journal/inbound`).
+
+## API Documentation
+
+For detailed API documentation, visit [docs.seven.io](https://docs.seven.io).
+
+## License
+
+MIT

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,129 @@
+#!/usr/bin/env node
+import { performOAuthFlow } from './oauth/flow.js';
+import { getTokens, deleteTokens, hasTokens } from './oauth/tokens.js';
+const CLIENT_ID = 'seven-mcp'; // Static OAuth client ID
+async function main() {
+    const command = process.argv[2];
+    switch (command) {
+        case 'login':
+            await handleLogin();
+            break;
+        case 'logout':
+            await handleLogout();
+            break;
+        case 'status':
+            await handleStatus();
+            break;
+        default:
+            showHelp();
+            process.exit(1);
+    }
+}
+async function handleLogin() {
+    try {
+        // Check if already logged in
+        if (await hasTokens()) {
+            console.log('You are already logged in.');
+            console.log('Run "seven-mcp logout" first if you want to log in again.');
+            process.exit(0);
+        }
+        // Perform OAuth flow
+        await performOAuthFlow({
+            clientId: CLIENT_ID,
+            scope: 'analytics balance contacts groups hooks journal lookup numbers pricing rcs sms status subaccounts validate_for_voice voice',
+        });
+        console.log('\n✓ Login successful!');
+        console.log('You can now use the seven.io MCP server with OAuth authentication.');
+    }
+    catch (error) {
+        console.error('\n✗ Login failed:', error.message);
+        process.exit(1);
+    }
+}
+async function handleLogout() {
+    try {
+        if (!(await hasTokens())) {
+            console.log('You are not logged in.');
+            process.exit(0);
+        }
+        const deleted = await deleteTokens();
+        if (deleted) {
+            console.log('✓ Logout successful. Tokens have been removed.');
+        }
+        else {
+            console.log('No tokens found to remove.');
+        }
+    }
+    catch (error) {
+        console.error('✗ Logout failed:', error.message);
+        process.exit(1);
+    }
+}
+async function handleStatus() {
+    try {
+        const tokens = await getTokens();
+        if (!tokens) {
+            console.log('Status: Not logged in');
+            console.log('\nRun "seven-mcp login" to authenticate.');
+            process.exit(0);
+        }
+        const now = Math.floor(Date.now() / 1000);
+        const expiresIn = tokens.expires_at - now;
+        console.log('Status: Logged in');
+        // Try to get account info from keychain
+        try {
+            const keytar = await import('keytar');
+            const k = keytar.default || keytar;
+            const account = await k.getPassword('seven-mcp', 'current-account');
+            if (account) {
+                console.log(`Account: ${account}`);
+            }
+        }
+        catch { }
+        console.log(`Token type: ${tokens.token_type}`);
+        console.log(`Scope: ${tokens.scope || 'N/A'}`);
+        if (expiresIn > 0) {
+            const minutes = Math.floor(expiresIn / 60);
+            const seconds = expiresIn % 60;
+            console.log(`Expires in: ${minutes}m ${seconds}s`);
+        }
+        else {
+            console.log('Token: EXPIRED (will be auto-refreshed on next use)');
+        }
+    }
+    catch (error) {
+        console.error('✗ Failed to check status:', error.message);
+        process.exit(1);
+    }
+}
+function showHelp() {
+    console.log(`
+seven-mcp - Seven.io MCP Server CLI
+
+USAGE:
+  seven-mcp <command>
+
+COMMANDS:
+  login     Authenticate with seven.io using OAuth
+  logout    Remove stored authentication tokens
+  status    Show current authentication status
+  help      Show this help message
+
+EXAMPLES:
+  # Login with OAuth
+  seven-mcp login
+
+  # Check authentication status
+  seven-mcp status
+
+  # Logout
+  seven-mcp logout
+
+For more information, visit https://github.com/yourusername/mcp-seven
+  `);
+}
+main().catch((error) => {
+    console.error('Fatal error:', error);
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/client.d.ts

@@ -0,0 +1,18 @@
+import type { SevenConfig } from './types.js';
+export declare class SevenClient {
+    private client;
+    private apiKey?;
+    private clientId?;
+    private useOAuth;
+    constructor(config: SevenConfig);
+    get<T>(path: string, params?: Record<string, any>): Promise<T>;
+    private encodeFormData;
+    post<T>(path: string, data?: Record<string, any>, options?: {
+        formEncoded?: boolean;
+    }): Promise<T>;
+    patch<T>(path: string, data?: Record<string, any>, options?: {
+        formEncoded?: boolean;
+    }): Promise<T>;
+    delete<T>(path: string): Promise<T>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAI9C,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,MAAM,CAAC,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAC,CAAS;IAC1B,OAAO,CAAC,QAAQ,CAAkB;gBAEtB,MAAM,EAAE,WAAW;IAwCzB,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAKpE,OAAO,CAAC,cAAc;IAahB,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,OAAO,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,CAAC,CAAC;IAWlG,KAAK,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,OAAO,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,CAAC,CAAC;IAWnG,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;CAI1C"}

package/dist/client.js

@@ -0,0 +1,88 @@
+import axios from 'axios';
+import { getValidAccessToken } from './oauth/refresh.js';
+import { getTokens } from './oauth/tokens.js';
+export class SevenClient {
+    client;
+    apiKey;
+    clientId;
+    useOAuth = false;
+    constructor(config) {
+        this.apiKey = config.apiKey;
+        this.clientId = config.clientId;
+        const baseUrl = config.baseUrl || 'https://gateway.seven.io/api';
+        this.client = axios.create({
+            baseURL: baseUrl,
+            headers: {
+                'Content-Type': 'application/json',
+            },
+        });
+        // Add request interceptor to handle authentication
+        this.client.interceptors.request.use(async (config) => {
+            // Try OAuth first if client ID is provided
+            if (this.clientId) {
+                try {
+                    const tokens = await getTokens();
+                    if (tokens) {
+                        const accessToken = await getValidAccessToken(this.clientId);
+                        config.headers.Authorization = `Bearer ${accessToken}`;
+                        this.useOAuth = true;
+                        return config;
+                    }
+                }
+                catch (error) {
+                    // Fall through to API key
+                }
+            }
+            // Fallback to API key
+            if (this.apiKey) {
+                config.headers['X-API-Key'] = this.apiKey;
+            }
+            else if (!this.useOAuth) {
+                throw new Error('No authentication method available. Please set SEVEN_API_KEY or run "seven-mcp login"');
+            }
+            return config;
+        });
+    }
+    async get(path, params) {
+        const response = await this.client.get(path, { params });
+        return response.data;
+    }
+    encodeFormData(data) {
+        const params = new URLSearchParams();
+        for (const [key, value] of Object.entries(data)) {
+            if (Array.isArray(value)) {
+                // For arrays, append each value with array bracket notation
+                value.forEach((item) => params.append(`${key}[]`, item));
+            }
+            else if (value !== undefined && value !== null) {
+                params.append(key, value);
+            }
+        }
+        return params.toString();
+    }
+    async post(path, data, options) {
+        const config = options?.formEncoded
+            ? {
+                headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
+                transformRequest: [(data) => this.encodeFormData(data)]
+            }
+            : {};
+        const response = await this.client.post(path, data, config);
+        return response.data;
+    }
+    async patch(path, data, options) {
+        const config = options?.formEncoded
+            ? {
+                headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
+                transformRequest: [(data) => this.encodeFormData(data)]
+            }
+            : {};
+        const response = await this.client.patch(path, data, config);
+        return response.data;
+    }
+    async delete(path) {
+        const response = await this.client.delete(path);
+        return response.data;
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}