1. fetch_url_content - Extract clean content from a single URL
2. fetch_multiple_urls - Batch process multiple URLs at once

• Multiple extraction engines: Trafilatura (articles), Readability (Mozilla algorithm), Basic (BeautifulSoup)
• Auto-fallback: Tries best method first, degrades gracefully
• Local processing: No external APIs, no rate limits. Well... yeah... I mean you will get throttled at some point :)
• Markdown output: LLMs love *.md
• Automatic citations: Includes source URL, title, author, date metadata
• Configurable: User controls extraction method, link inclusion, metadata display

Single page:

"Fetch https://en.wikipedia.org/wiki/Python_(programming_language) and summarize the key features"
"Extract the installation instructions from https://github.com/project/readme"
"Read https://arxiv.org/abs/2311.12345 and explain the methodology in simple terms"

Multiple pages:

"Compare these articles: https://site1.com/view1, https://site2.com/view2"

1. search_documents - General full-text search
2. search_by_tags - Filter by tags (any or all)
3. search_by_type_and_tags - Filter by document type + tags
4. search_by_correspondent - Filter by sender/source
5. list_all_tags - See available tags
6. list_document_types - See available types
7. list_correspondents - See available correspondents
8. get_document_by_id - Direct document access
9. find_similar_documents - ML-based similarity
10. advanced_document_search - Kitchen sink with all filters

• Natural language search: Resolves tag/type/correspondent names to IDs automatically
• Full content extraction: Retrieves complete document text for further analysis
• Smart filtering: Combine multiple criteria (type + tags + correspondent + dates)
• Automatic citations: Creates proper references with metadata
• Real-time status: Progress updates during search and retrieval
• Configurable limits: Control result count and content size

By type and tags:

"Show me all invoices tagged framework and 2025"
"Find receipts with tag 'business expense'"

By correspondent and type:

"Find all invoices from Framework"
"Show me contracts from ACME Corporation"

→ Uses search_by_correspondent(correspondent="Framework", document_type="invoice")

By correspondent, type, AND tags:

"Show me all invoices from Framework with tag 'computer' from 2025"

→ Uses search_by_correspondent(correspondent="Framework", document_type="invoice", tags="computer", query="2025")

Discovery functions:

"What document types do I have?"
"List all my correspondents"
"Show me all available tags"

1. read_file - Read any file from a repository (public or private)
2. list_repository_files - Browse repository file structure
3. get_repository_info - Get repository metadata and statistics
4. list_my_gists - List all your gists
5. get_gist - Read a gist by ID (with syntax highlighting)
6. create_gist - Create a new gist (public or secret)
7. update_gist - Update existing gist content
8. delete_gist - Delete a gist
9. list_workflows - List all workflows in a repository
10. list_workflow_runs - List workflow runs with filtering (status, branch, workflow)
11. get_workflow_run - Get detailed status of a specific run (includes jobs)
12. trigger_workflow - Trigger a workflow_dispatch event
13. cancel_workflow_run - Cancel a running workflow

• Public & private repos: Works with any repository you have access to
• Syntax highlighting: Automatic language detection for code display
• Code search: Find specific functions, patterns, or implementations
• Gist management: Full CRUD operations for gists (create, read, update, delete)
• Multi-file gists: Support for gists with multiple files
• Workflow monitoring: Check status of GitHub Actions runs
• Workflow triggering: Start workflows with custom inputs via workflow_dispatch
• Job details: View individual job status within workflow runs
• Filtering: Filter workflow runs by status, branch, or specific workflow
• Automatic citations: Links back to source files and gists on GitHub

Read files:

"Read the main.py file from myusername/my-project"
"Show me the README from torvalds/linux"
"Read src/components/Header.tsx from facebook/react branch next"

Browse structure:

"List all files in microsoft/vscode"
"Show me the directory structure of my-org/private-repo"
"What files are in the src/ directory of rust-lang/rust?"

Search code:

"Search for 'async def' in my Python repositories"
"Find examples of useEffect in repo facebook/react"
"Search for JWT authentication code in language:python"

Repository info:

"Tell me about the repository kubernetes/kubernetes"
"What languages are used in tensorflow/tensorflow?"
"Show me stats for my-username/my-private-repo"

Code analysis:

"Read the authentication module from my-org/api-server and explain how it works"
"Compare the implementation in file1.py and file2.py from my-repo"
"Find all API endpoints in my-backend/server and list them"

List your gists:

"Show me my recent gists"
"List my GitHub gists"

Read a gist:

"Get gist abc123def456"
"Show me the content of gist abc123"

Create a gist:

"Create a public gist with description 'Python helper functions' and files: helpers.py=def hello(): print('hi')|||test.py=print('test')"

Note: The file format for files parameter is: filename1.ext=content1|||filename2.ext=content2 - this allows multiple files per gist!

Update a gist:

"Update gist abc123 with new description 'Updated helpers'"
"Update gist abc123 files: helpers.py=def hello(): print('updated')"

Delete a gist:

"Delete gist abc123"

List all workflows:

"Show me all workflows in myorg/myrepo"
"List workflows in my repository"

Check workflow runs:

"Show me recent workflow runs for myorg/myrepo"
"List failed workflow runs in myorg/myrepo"
"Show workflow runs for ci.yml on main branch"

Get specific run details:

"Get details for workflow run 12345678 in myorg/myrepo"
"Show me the status of run #12345678"

Trigger a workflow:

"Trigger workflow ci.yml in myorg/myrepo on main branch"
"Run workflow deploy.yml with inputs: environment=production|||version=1.2.3"

Cancel a run:

"Cancel workflow run 12345678 in myorg/myrepo"

1. For public repos: Works immediately, no configuration needed
2. For private repos:
   • Go to GitHub Settings → Developer settings → Personal access tokens
   • Click "Generate new token (classic)"
   • Select scopes: repo (full control of private repositories), gists (full control of gists) and workflow
   • Copy token and add to tool settings