Open-source social media scheduler built for AI agents and the teams behind them. Create, schedule and publish posts to every network through MCP or the REST API, or write them yourself in a composer your team will love.
PHP ai-agentsblueskyfacebookinstagramlaravellinkedinmastodonmcpmcp-serveropen-sourcerest-apiself-hostedsocial-mediasocial-media-managementsocial-media-schedulerthreadstiktokvuejsxyoutube
<?php
declare(strict_types=1);
use App\Models\AccessToken;
use App\Models\User;
use App\Models\Workspace;
use Illuminate\Support\Facades\DB;
use Illuminate\Support\Str;
beforeEach(function (): void {
config(['trypost.self_hosted' => false]);
$this->user = User::factory()->create();
$this->workspace = Workspace::factory()->create([
'account_id' => $this->user->account_id,
'user_id' => $this->user->id,
]);
$this->workspace->members()->attach($this->user->id, membershipPivot('admin'));
$this->user->update(['current_workspace_id' => $this->workspace->id]);
$this->user->refresh();
// SaaS mode: the MCP settings live behind EnsureAccountReady.
subscribeAccount($this->user->account);
});
it('shows the mcp settings page', function (): void {
$this->actingAs($this->user)
->get(route('app.mcp.index'))
->assertOk()
->assertInertia(fn ($page) => $page
->component('settings/workspace/Mcp')
->where('mcpUrl', route('mcp.trypost'))
->missing('docsUrl')
->missing('mcpClients')
->has('connectedClients'));
});
it('shows the mcp settings page without a subscription in self-hosted mode', function (): void {
config(['trypost.self_hosted' => true]);
$this->user->account->subscriptions()->delete();
$this->actingAs($this->user->fresh())
->get(route('app.mcp.index'))
->assertOk()
->assertInertia(fn ($page) => $page
->component('settings/workspace/Mcp')
->where('mcpUrl', route('mcp.trypost')));
});
it('lists only the current users oauth clients as connected, excluding personal access tokens', function (): void {
$member = User::factory()->create(['account_id' => $this->user->account_id]);
$this->workspace->members()->attach($member->id, membershipPivot('member'));
$member->update(['current_workspace_id' => $this->workspace->id]);
$ownerClientId = mcpOauthClient('Owner Agent');
mcpAccessToken($this->user, $ownerClientId, $this->workspace);
$memberClientId = mcpOauthClient('Member Agent');
mcpAccessToken($member, $memberClientId, $this->workspace);
$pat = $this->user->createToken('API Key');
AccessToken::query()->findOrFail($pat->token->id)
->forceFill(['workspace_id' => $this->workspace->id])
->saveQuietly();
$this->actingAs($this->user)
->get(route('app.mcp.index'))
->assertInertia(fn ($page) => $page
->has('connectedClients', 1)
->where('connectedClients.0.name', 'Owner Agent')
->where('connectedClients.0.can_disconnect', true)
->where('connectedClients', fn ($clients): bool => collect($clients)->every(
fn (array $client): bool => $client['name'] !== 'Member Agent',
)));
});
it('excludes unscoped oauth grants from connected clients', function (): void {
mcpAccessToken($this->user, mcpOauthClient('Unscoped Agent'), $this->workspace, scopes: []);
$this->actingAs($this->user)
->get(route('app.mcp.index'))
->assertInertia(fn ($page) => $page->where('connectedClients', []));
});
it('lists the own oauth grants of a member who needs approval as connected clients', function (): void {
$requester = User::factory()->create(['account_id' => $this->user->account_id]);
$this->workspace->members()->attach($requester->id, membershipPivot('approval'));
$requester->update(['current_workspace_id' => $this->workspace->id]);
mcpAccessToken($requester, mcpOauthClient('Requester Agent'), $this->workspace);
$this->actingAs($requester->fresh())
->get(route('app.mcp.index'))
->assertInertia(fn ($page) => $page
->has('connectedClients', 1)
->where('connectedClients.0.name', 'Requester Agent')
->where('connectedClients.0.can_disconnect', true));
});
it('disconnects a client by revoking its tokens', function (): void {
$clientId = mcpOauthClient();
$token = mcpAccessToken($this->user, $clientId, $this->workspace);
$this->actingAs($this->user)
->delete(route('app.mcp.disconnect', ['client' => $clientId]))
->assertRedirect()
->assertSessionHas('flash.success', __('mcp.disconnected'));
expect($token->fresh()->revoked)->toBeTrue();
});
it('disconnects a client when its access token expired but its refresh token is live', function (): void {
$clientId = mcpOauthClient();
$token = mcpAccessToken($this->user, $clientId, $this->workspace);
$token->forceFill(['expires_at' => now()->subMinute()])->saveQuietly();
$refreshTokenId = Str::random(80);
DB::table('oauth_refresh_tokens')->insert([
'id' => $refreshTokenId,
'access_token_id' => $token->id,
'revoked' => false,
'expires_at' => now()->addMonth(),
]);
$this->actingAs($this->user)
->delete(route('app.mcp.disconnect', ['client' => $clientId]))
->assertRedirect()
->assertSessionHas('flash.success');
expect($token->fresh()->revoked)->toBeTrue()
->and((bool) DB::table('oauth_refresh_tokens')->where('id', $refreshTokenId)->value('revoked'))->toBeTrue();
});
it('lists a client when its access token expired but its refresh token is live', function (): void {
$clientId = mcpOauthClient('Recoverable Agent');
$token = mcpAccessToken($this->user, $clientId, $this->workspace);
$token->forceFill(['expires_at' => now()->subMinute()])->saveQuietly();
DB::table('oauth_refresh_tokens')->insert([
'id' => Str::random(80),
'access_token_id' => $token->id,
'revoked' => false,
'expires_at' => now()->addMonth(),
]);
$this->actingAs($this->user)
->get(route('app.mcp.index'))
->assertOk()
->assertInertia(fn ($page) => $page
->has('connectedClients', 1)
->where('connectedClients.0.name', 'Recoverable Agent')
->where('connectedClients.0.can_disconnect', true));
});
it('hides a client when both access and refresh tokens are expired', function (): void {
$clientId = mcpOauthClient('Dead Agent');
$token = mcpAccessToken($this->user, $clientId, $this->workspace);
$token->forceFill(['expires_at' => now()->subMinute()])->saveQuietly();
DB::table('oauth_refresh_tokens')->insert([
'id' => Str::random(80),
'access_token_id' => $token->id,
'revoked' => false,
'expires_at' => now()->subMinute(),
]);
$this->actingAs($this->user)
->get(route('app.mcp.index'))
->assertOk()
->assertInertia(fn ($page) => $page->where('connectedClients', []));
});
it('does not flash success when disconnecting an unknown client', function (): void {
$this->actingAs($this->user)
->delete(route('app.mcp.disconnect', ['client' => (string) Str::uuid()]))
->assertRedirect()
->assertSessionMissing('flash.success');
});
it('does not list a teammates mcp connection', function (): void {
$member = User::factory()->create(['account_id' => $this->user->account_id]);
$this->workspace->members()->attach($member->id, membershipPivot('member'));
$member->update(['current_workspace_id' => $this->workspace->id]);
mcpAccessToken($this->user, mcpOauthClient('Owner Agent'), $this->workspace);
$this->actingAs($member->fresh())
->get(route('app.mcp.index'))
->assertOk()
->assertInertia(fn ($page) => $page->where('connectedClients', []));
});
it('allows workspace members to view and disconnect their own mcp clients', function (): void {
$member = User::factory()->create(['account_id' => $this->user->account_id]);
$this->workspace->members()->attach($member->id, membershipPivot('member'));
$member->update(['current_workspace_id' => $this->workspace->id]);
$clientId = mcpOauthClient('Member Agent');
$token = mcpAccessToken($member, $clientId, $this->workspace);
$this->actingAs($member->fresh())
->get(route('app.mcp.index'))
->assertOk()
->assertInertia(fn ($page) => $page
->has('connectedClients', 1)
->where('connectedClients.0.name', 'Member Agent'));
$this->actingAs($member->fresh())
->delete(route('app.mcp.disconnect', ['client' => $clientId]))
->assertRedirect()
->assertSessionHas('flash.success');
expect($token->fresh()->revoked)->toBeTrue();
});
it('allows members who need approval to view and disconnect their own mcp clients', function (): void {
$requester = User::factory()->create(['account_id' => $this->user->account_id]);
$this->workspace->members()->attach($requester->id, membershipPivot('approval'));
$requester->update(['current_workspace_id' => $this->workspace->id]);
$clientId = mcpOauthClient('Requester Agent');
$token = mcpAccessToken($requester, $clientId, $this->workspace);
$this->actingAs($requester->fresh())
->get(route('app.mcp.index'))
->assertOk()
->assertInertia(fn ($page) => $page
->component('settings/workspace/Mcp')
->has('connectedClients', 1)
->where('connectedClients.0.name', 'Requester Agent')
->where('connectedClients.0.can_disconnect', true));
$this->actingAs($requester->fresh())
->delete(route('app.mcp.disconnect', ['client' => $clientId]))
->assertRedirect()
->assertSessionHas('flash.success');
expect($token->fresh()->revoked)->toBeTrue();
});
it('does not revoke another users mcp client tokens', function (): void {
$member = User::factory()->create(['account_id' => $this->user->account_id]);
$this->workspace->members()->attach($member->id, membershipPivot('member'));
$member->update(['current_workspace_id' => $this->workspace->id]);
$clientId = mcpOauthClient('Owner Agent');
$token = mcpAccessToken($this->user, $clientId, $this->workspace);
$this->actingAs($member->fresh())
->delete(route('app.mcp.disconnect', ['client' => $clientId]))
->assertRedirect()
->assertSessionMissing('flash.success');
expect($token->fresh()->revoked)->toBeFalse();
});
it('does not revoke personal access tokens via disconnect', function (): void {
$pat = $this->user->createToken('API Key');
$token = AccessToken::query()->findOrFail($pat->token->id);
$token->forceFill(['workspace_id' => $this->workspace->id])->saveQuietly();
$this->actingAs($this->user)
->delete(route('app.mcp.disconnect', ['client' => $token->client_id]))
->assertRedirect()
->assertSessionMissing('flash.success');
expect($token->fresh()->revoked)->toBeFalse();
});
it('lists only mcp connections for the current workspace', function (): void {
$workspaceB = Workspace::factory()->create([
'account_id' => $this->user->account_id,
'user_id' => $this->user->id,
'name' => 'Workspace B',
]);
$workspaceB->members()->attach($this->user->id, membershipPivot('admin'));
$clientId = mcpOauthClient('Claude');
mcpAccessToken($this->user, $clientId, $this->workspace);
mcpAccessToken($this->user, $clientId, $workspaceB);
$this->actingAs($this->user)
->get(route('app.mcp.index'))
->assertOk()
->assertInertia(fn ($page) => $page
->has('connectedClients', 1)
->where('connectedClients.0.client_id', $clientId)
->where('connectedClients.0.name', 'Claude'));
$this->user->update(['current_workspace_id' => $workspaceB->id]);
$this->actingAs($this->user->fresh())
->get(route('app.mcp.index'))
->assertOk()
->assertInertia(fn ($page) => $page
->has('connectedClients', 1)
->where('connectedClients.0.client_id', $clientId)
->where('connectedClients.0.name', 'Claude'));
});
it('orders connected mcp clients by last used descending', function (): void {
$older = mcpAccessToken($this->user, mcpOauthClient('Older Agent'), $this->workspace);
$newer = mcpAccessToken($this->user, mcpOauthClient('Newer Agent'), $this->workspace);
$older->forceFill(['last_used_at' => now()->subDay()])->saveQuietly();
$newer->forceFill(['last_used_at' => now()])->saveQuietly();
$this->actingAs($this->user)
->get(route('app.mcp.index'))
->assertOk()
->assertInertia(fn ($page) => $page
->has('connectedClients', 2)
->where('connectedClients.0.name', 'Newer Agent')
->where('connectedClients.1.name', 'Older Agent'));
});
it('orders a never-used client last instead of crashing', function (): void {
$used = mcpAccessToken($this->user, mcpOauthClient('Used Agent'), $this->workspace);
$neverUsed = mcpAccessToken($this->user, mcpOauthClient('Fresh Agent'), $this->workspace);
$used->forceFill(['last_used_at' => now()->subHour()])->saveQuietly();
$neverUsed->forceFill(['last_used_at' => null])->saveQuietly();
$this->actingAs($this->user)
->get(route('app.mcp.index'))
->assertOk()
->assertInertia(fn ($page) => $page
->has('connectedClients', 2)
->where('connectedClients.0.name', 'Used Agent')
->where('connectedClients.1.name', 'Fresh Agent'));
});
it('lists clients that have never been used', function (): void {
$first = mcpAccessToken($this->user, mcpOauthClient('First Agent'), $this->workspace);
$second = mcpAccessToken($this->user, mcpOauthClient('Second Agent'), $this->workspace);
$first->forceFill(['last_used_at' => null])->saveQuietly();
$second->forceFill(['last_used_at' => null])->saveQuietly();
$this->actingAs($this->user)
->get(route('app.mcp.index'))
->assertOk()
->assertInertia(fn ($page) => $page->has('connectedClients', 2));
});
it('does not list unbound mcp grants', function (): void {
mcpAccessToken($this->user, mcpOauthClient('Legacy Agent'), workspace: null);
$this->actingAs($this->user)
->get(route('app.mcp.index'))
->assertOk()
->assertInertia(fn ($page) => $page->where('connectedClients', []));
});
it('disconnects a client only on the current workspace', function (): void {
$workspaceB = Workspace::factory()->create([
'account_id' => $this->user->account_id,
'user_id' => $this->user->id,
]);
$workspaceB->members()->attach($this->user->id, membershipPivot('admin'));
$clientId = mcpOauthClient('Claude');
$onA = mcpAccessToken($this->user, $clientId, $this->workspace);
$onB = mcpAccessToken($this->user, $clientId, $workspaceB);
$this->actingAs($this->user)
->delete(route('app.mcp.disconnect', ['client' => $clientId]))
->assertRedirect()
->assertSessionHas('flash.success');
expect($onA->fresh()->revoked)->toBeTrue()
->and($onB->fresh()->revoked)->toBeFalse();
$this->user->update(['current_workspace_id' => $workspaceB->id]);
$this->actingAs($this->user->fresh())
->get(route('app.mcp.index'))
->assertOk()
->assertInertia(fn ($page) => $page
->has('connectedClients', 1)
->where('connectedClients.0.client_id', $clientId));
});
it('requires authentication', function (): void {
$this->get(route('app.mcp.index'))->assertRedirect();
});
it('forbids users without workspace access', function (): void {
$outsider = User::factory()->create();
subscribeAccount($outsider->account);
$outsider->update(['current_workspace_id' => $this->workspace->id]);
$this->actingAs($outsider->fresh())
->get(route('app.mcp.index'))
->assertForbidden();
});
it('redirects to welcome when the account has no app access', function (): void {
$this->user->account->subscriptions()->delete();
$this->actingAs($this->user->fresh())
->get(route('app.mcp.index'))
->assertRedirect(route('app.welcome.plan'));
});