Skip to content

feat(examples): add MCP client connection example with OAuth #72

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom
Open
Larry-Osakwe wants to merge 1 commit into
base: main
Choose a base branch
from
Open

feat(examples): add MCP client connection example with OAuth #72

Larry-Osakwe wants to merge 1 commit into from

Conversation

@Larry-Osakwe
Copy link
Contributor

@Larry-Osakwe Larry-Osakwe commented Feb 10, 2026

Summary

  • Adds /packages/mcp/examples/client_connection/ example demonstrating MCP client connections with OAuth authentication
  • Shows StarletteAuthCoordinator for handling OAuth callbacks in web applications
  • Demonstrates session status lifecycle (auth_pending -> connected)
  • Includes comprehensive README with setup instructions and flow diagrams

Key Patterns Demonstrated

  • Setting up StarletteAuthCoordinator with SQLite storage
  • Session status checking (is_operational, requires_user_action)
  • Getting auth challenges and authorization URLs
  • Tool calling after authentication

Test Plan

  • Start hello_world_server with a Keycard zone
  • Run client_connection example
  • Open http://localhost:8080 and verify auth_pending status
  • Complete OAuth flow in browser
  • Verify connected status and tool calling works

Closes AGE-16

@Larry-Osakwe
feat(examples): add MCP client connection example with OAuth
4cc3e0b 
Demonstrates connecting to authenticated MCP servers using
StarletteAuthCoordinator for OAuth callback handling.

Key patterns shown:
- Session status lifecycle checking
- Auth challenge handling with redirect URLs
- Tool calling after authentication
- SQLite token persistence
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

No reviews

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

1 participant

@Larry-Osakwe